Skip to content

API reference

My reviews and goals

A person's own review to-dos, feedback requests and goals (Me keys read; reviews and feedback are written in the app).

5 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.

Choose my peer reviewers#

POST/v1/talent/feedback.nominateWrite

Chooses the colleagues you would like peer feedback from in your review (3–8, by the cycle's nomination date): person_ids replaces your earlier choice of those not yet asked. Your manager approves, swaps or adds. Their answers reach you only as a group of at least the company's threshold (3 or more), never with names. In the app only.

Web app only
Refused for API keys and connected apps. People choose their peers in the app only.
MCP tool
talent_feedback_nominate on My Workplace
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity

Input

  • review_idstringrequired
  • person_idsstring[]required

    1–200 characters. 3–8 items.

Returns

10 fields
  • review_idstringrequired
  • cycleobjectrequired
    4 fields
    • idstringrequired
    • namestringrequired
    • nominate_bystring | nullrequired
    • peer_duestring | nullrequired
  • personobjectrequired
    2 fields
    • idstringrequired
    • namestringrequired
  • peopleobject[]required
    2 fields
    • personobjectrequired
      2 fields
      • idstringrequired
      • namestringrequired
    • state"nominated" | "asked"required

      asked: approved (whether they answered or declined is never shown).

  • countsobject | nullrequired

    The reviewer and HR: how many answered (never who).

    2 fields
    • askedintegerrequired
    • answeredintegerrequired
  • minintegerrequired
  • maxintegerrequired
  • fullstring[]required

    People already asked for the most peer reviews this cycle (12): pick someone else.

  • can_nominatebooleanrequired
  • can_decidebooleanrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/feedback.nominate \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"review_id":"rv1","person_ids":["p3","p4","p5"]}'
Response
{
  "data": {
    "review_id": "rv1",
    "cycle": {
      "id": "cy1",
      "name": "Annual review 2026",
      "nominate_by": "2026-11-18",
      "peer_due": "2026-11-24"
    },
    "person": {
      "id": "p2",
      "name": "Tomás Silva"
    },
    "people": [
      {
        "person": {
          "id": "p3",
          "name": "Rita Gomes"
        },
        "state": "asked"
      }
    ],
    "counts": null,
    "min": 3,
    "max": 8,
    "full": [],
    "can_nominate": true,
    "can_decide": false
  }
}

Feedback I was asked for#

POST/v1/talent/feedback.mineRead

The peer and upward feedback you were asked for: whose review, the questions, your answers, the due date. Answers are shown to them only as a group of at least the company's threshold, never with your name; you can decline without a reason. Your own requests only, in the app: API keys and AI assistants can't read them.

Web app only
Refused for API keys and connected apps. Feedback requests are answered in the app only.
MCP tool
talent_feedback_mine on My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • itemsobject[]required
    9 fields
    • idstringrequired

      Your request (only you ever see it).

    • cycleobjectrequired
      3 fields
      • idstringrequired
      • namestringrequired
      • peer_duestring | nullrequired
    • subjectobjectrequired
      2 fields
      • idstringrequired
      • namestringrequired
    • kind"peer" | "upward"required
    • status"approved" | "declined" | "submitted" | "withdrawn"required
    • sectionsobject[]required
      5 fields
      • idstringrequired
      • titlestringrequired
      • titlesobject
        4 fields
        • selfstring
        • managerstring
        • peerstring
        • upwardstring
      • show_goalsbooleanrequired
      • questionsobject[]required
        6 fields
        • idstringrequired
        • textstringrequired
        • textsobject

          Wording per step (self in the first person); text when absent.

          4 fields
          • selfstring
          • managerstring
          • peerstring
          • upwardstring
        • kind"rating" | "text" | "both"required
        • requiredbooleanrequired
        • for"self" | "manager" | "peer" | "upward"[]required
    • scaleobjectrequired
      3 fields
      • idstringrequired
      • namestringrequired
      • pointsobject[]required
        3 fields
        • valueintegerrequired
        • labelstringrequired
        • descriptionstringrequired
    • answersobject[]required
      3 fields
      • question_idstringrequired
      • ratinginteger | nullrequired
      • textstring | nullrequired
    • thresholdintegerrequired

      Answers are shown only as a group of at least this many people, never with your name.

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/feedback.mine \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "data": {
    "items": [
      {
        "id": "fb1",
        "cycle": {
          "id": "cy1",
          "name": "Annual review 2026",
          "peer_due": "2026-11-24"
        },
        "subject": {
          "id": "p2",
          "name": "Tomás Silva"
        },
        "kind": "peer",
        "status": "approved",
        "sections": [
          {
            "id": "s1",
            "title": "Progress",
            "show_goals": true,
            "questions": [
              {
                "id": "q1",
                "text": "Where are the goals now?",
                "kind": "text",
                "required": true,
                "for": [
                  "self",
                  "manager"
                ]
              }
            ]
          },
          {
            "id": "s2",
            "title": "Overall",
            "show_goals": false,
            "questions": [
              {
                "id": "q3",
                "text": "Overall rating so far.",
                "kind": "rating",
                "required": true,
                "for": [
                  "manager"
                ]
              }
            ]
          }
        ],
        "scale": {
          "id": "five",
          "name": "5-point",
          "points": [
            {
              "value": 1,
              "label": "Well below expectations",
              "description": "Results and behaviours fall well short of what the role needs."
            },
            {
              "value": 2,
              "label": "Below expectations",
              "description": "Some of what the role needs is missing; clear gaps to close."
            },
            {
              "value": 3,
              "label": "Meets expectations",
              "description": "Delivers what the role needs, reliably."
            },
            {
              "value": 4,
              "label": "Exceeds expectations",
              "description": "Often goes beyond what the role needs."
            },
            {
              "value": 5,
              "label": "Outstanding",
              "description": "Consistently far beyond what the role needs; a model for others."
            }
          ]
        },
        "answers": [],
        "threshold": 3
      }
    ]
  }
}

Give feedback#

POST/v1/talent/feedback.answerWrite

Saves (submit false) or sends (submit true: every required question answered) your answers to a feedback request. Once sent it can't be changed. Shown to the person only in a group of at least the threshold, never with your name. In the app only.

Web app only
Refused for API keys and connected apps. Feedback is given in the app only.
MCP tool
talent_feedback_answer on My Workplace
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity

Input

  • feedback_idstringrequired
  • answersobject[]required

    Up to 30 items.

    3 fields
    • question_idstringrequired

      1–40 characters.

    • ratinginteger | null

      From 1 to 7.

    • textstring | null

      Up to 5000 characters.

  • submitboolean

    Default false.

Returns

9 fields
  • idstringrequired

    Your request (only you ever see it).

  • cycleobjectrequired
    3 fields
    • idstringrequired
    • namestringrequired
    • peer_duestring | nullrequired
  • subjectobjectrequired
    2 fields
    • idstringrequired
    • namestringrequired
  • kind"peer" | "upward"required
  • status"approved" | "declined" | "submitted" | "withdrawn"required
  • sectionsobject[]required
    5 fields
    • idstringrequired
    • titlestringrequired
    • titlesobject
      4 fields
      • selfstring
      • managerstring
      • peerstring
      • upwardstring
    • show_goalsbooleanrequired
    • questionsobject[]required
      6 fields
      • idstringrequired
      • textstringrequired
      • textsobject

        Wording per step (self in the first person); text when absent.

        4 fields
        • selfstring
        • managerstring
        • peerstring
        • upwardstring
      • kind"rating" | "text" | "both"required
      • requiredbooleanrequired
      • for"self" | "manager" | "peer" | "upward"[]required
  • scaleobjectrequired
    3 fields
    • idstringrequired
    • namestringrequired
    • pointsobject[]required
      3 fields
      • valueintegerrequired
      • labelstringrequired
      • descriptionstringrequired
  • answersobject[]required
    3 fields
    • question_idstringrequired
    • ratinginteger | nullrequired
    • textstring | nullrequired
  • thresholdintegerrequired

    Answers are shown only as a group of at least this many people, never with your name.

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/feedback.answer \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "feedback_id": "fb1",
  "answers": [
    {
      "question_id": "q1",
      "text": "Clear priorities."
    }
  ],
  "submit": true
}'
Response
{
  "data": {
    "id": "fb1",
    "cycle": {
      "id": "cy1",
      "name": "Annual review 2026",
      "peer_due": "2026-11-24"
    },
    "subject": {
      "id": "p2",
      "name": "Tomás Silva"
    },
    "kind": "peer",
    "status": "submitted",
    "sections": [
      {
        "id": "s1",
        "title": "Progress",
        "show_goals": true,
        "questions": [
          {
            "id": "q1",
            "text": "Where are the goals now?",
            "kind": "text",
            "required": true,
            "for": [
              "self",
              "manager"
            ]
          }
        ]
      },
      {
        "id": "s2",
        "title": "Overall",
        "show_goals": false,
        "questions": [
          {
            "id": "q3",
            "text": "Overall rating so far.",
            "kind": "rating",
            "required": true,
            "for": [
              "manager"
            ]
          }
        ]
      }
    ],
    "scale": {
      "id": "five",
      "name": "5-point",
      "points": [
        {
          "value": 1,
          "label": "Well below expectations",
          "description": "Results and behaviours fall well short of what the role needs."
        },
        {
          "value": 2,
          "label": "Below expectations",
          "description": "Some of what the role needs is missing; clear gaps to close."
        },
        {
          "value": 3,
          "label": "Meets expectations",
          "description": "Delivers what the role needs, reliably."
        },
        {
          "value": 4,
          "label": "Exceeds expectations",
          "description": "Often goes beyond what the role needs."
        },
        {
          "value": 5,
          "label": "Outstanding",
          "description": "Consistently far beyond what the role needs; a model for others."
        }
      ]
    },
    "answers": [],
    "threshold": 3
  }
}

Decline a feedback request#

POST/v1/talent/feedback.declineWrite

Declines a feedback request you were asked for, with no reason. Nobody is told who declined. In the app only.

Web app only
Refused for API keys and connected apps. Declining happens in the app only.
MCP tool
talent_feedback_decline on My Workplace
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity

Input

  • feedback_idstringrequired

Returns

9 fields
  • idstringrequired

    Your request (only you ever see it).

  • cycleobjectrequired
    3 fields
    • idstringrequired
    • namestringrequired
    • peer_duestring | nullrequired
  • subjectobjectrequired
    2 fields
    • idstringrequired
    • namestringrequired
  • kind"peer" | "upward"required
  • status"approved" | "declined" | "submitted" | "withdrawn"required
  • sectionsobject[]required
    5 fields
    • idstringrequired
    • titlestringrequired
    • titlesobject
      4 fields
      • selfstring
      • managerstring
      • peerstring
      • upwardstring
    • show_goalsbooleanrequired
    • questionsobject[]required
      6 fields
      • idstringrequired
      • textstringrequired
      • textsobject

        Wording per step (self in the first person); text when absent.

        4 fields
        • selfstring
        • managerstring
        • peerstring
        • upwardstring
      • kind"rating" | "text" | "both"required
      • requiredbooleanrequired
      • for"self" | "manager" | "peer" | "upward"[]required
  • scaleobjectrequired
    3 fields
    • idstringrequired
    • namestringrequired
    • pointsobject[]required
      3 fields
      • valueintegerrequired
      • labelstringrequired
      • descriptionstringrequired
  • answersobject[]required
    3 fields
    • question_idstringrequired
    • ratinginteger | nullrequired
    • textstring | nullrequired
  • thresholdintegerrequired

    Answers are shown only as a group of at least this many people, never with your name.

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/feedback.decline \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"feedback_id":"fb1"}'
Response
{
  "data": {
    "id": "fb1",
    "cycle": {
      "id": "cy1",
      "name": "Annual review 2026",
      "peer_due": "2026-11-24"
    },
    "subject": {
      "id": "p2",
      "name": "Tomás Silva"
    },
    "kind": "peer",
    "status": "declined",
    "sections": [
      {
        "id": "s1",
        "title": "Progress",
        "show_goals": true,
        "questions": [
          {
            "id": "q1",
            "text": "Where are the goals now?",
            "kind": "text",
            "required": true,
            "for": [
              "self",
              "manager"
            ]
          }
        ]
      },
      {
        "id": "s2",
        "title": "Overall",
        "show_goals": false,
        "questions": [
          {
            "id": "q3",
            "text": "Overall rating so far.",
            "kind": "rating",
            "required": true,
            "for": [
              "manager"
            ]
          }
        ]
      }
    ],
    "scale": {
      "id": "five",
      "name": "5-point",
      "points": [
        {
          "value": 1,
          "label": "Well below expectations",
          "description": "Results and behaviours fall well short of what the role needs."
        },
        {
          "value": 2,
          "label": "Below expectations",
          "description": "Some of what the role needs is missing; clear gaps to close."
        },
        {
          "value": 3,
          "label": "Meets expectations",
          "description": "Delivers what the role needs, reliably."
        },
        {
          "value": 4,
          "label": "Exceeds expectations",
          "description": "Often goes beyond what the role needs."
        },
        {
          "value": 5,
          "label": "Outstanding",
          "description": "Consistently far beyond what the role needs; a model for others."
        }
      ]
    },
    "answers": [],
    "threshold": 3
  }
}

My reviews and feedback to do#

POST/v1/talent/me.homeRead

What performance and talent asks of you now: your self-reviews and their due dates, peers to choose, feedback you were asked for, which reviews you can read (from their release date), your open goals and, for managers, reviews to write, sign-offs and nominations to approve. Before a review is released you see only its release date, never its status.

Who can call it
Me key owner admin hr member
MCP tool
talent_me_home on My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • reviewsobject[]required
    7 fields
    • review_idstringrequired
    • cycleobjectrequired
      2 fields
      • idstringrequired
      • namestringrequired
    • self"todo" | "done" | "n/a"required
    • self_duestring | nullrequired
    • peersobject | nullrequired

      Choosing peer reviewers, when the cycle has peers.

      3 fields
      • openbooleanrequired
      • bystring | nullrequired
      • chosenintegerrequired
    • release_onstringrequired
    • releasedbooleanrequired

      true once you can read it; false says nothing about its status (only the date).

  • feedbackobject[]required
    5 fields
    • idstringrequired
    • cycleobjectrequired
      2 fields
      • idstringrequired
      • namestringrequired
    • subjectobjectrequired
      2 fields
      • idstringrequired
      • namestringrequired
    • kind"peer" | "upward"required
    • duestring | nullrequired
  • teamobject | nullrequired

    Managers: what their team's reviews need from them.

    3 fields
    • to_writeintegerrequired
    • signoffsintegerrequired
    • nominationsintegerrequired
  • goalsobjectrequired
    2 fields
    • openintegerrequired
    • at_riskintegerrequired
  • profile_promptbooleanrequired

    Talent profiles: you have not answered "Show my profile to colleagues?" yet (spec 2026-11-21-internal-talent T2; asked once).

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/me.home \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "data": {
    "reviews": [
      {
        "review_id": "rv1",
        "cycle": {
          "id": "cy1",
          "name": "Annual review 2026"
        },
        "self": "todo",
        "self_due": "2026-11-25",
        "peers": {
          "open": true,
          "by": "2026-11-18",
          "chosen": 0
        },
        "release_on": "2026-12-02",
        "released": false
      }
    ],
    "feedback": [
      {
        "id": "fb1",
        "cycle": {
          "id": "cy1",
          "name": "Annual review 2026"
        },
        "subject": {
          "id": "p2",
          "name": "Tomás Silva"
        },
        "kind": "peer",
        "due": "2026-11-24"
      }
    ],
    "team": {
      "to_write": 4,
      "signoffs": 0,
      "nominations": 1
    },
    "goals": {
      "open": 3,
      "at_risk": 1
    },
    "profile_prompt": true
  }
}

Something missing or wrong on this page? Write to hello@bizisy.com.

Developer docs