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_nominateon My Workplace- Preview
?dry_run=trueruns 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_idstringrequiredperson_idsstring[]required1–200 characters. 3–8 items.
Returns
10 fields
review_idstringrequiredcycleobjectrequired4 fields
idstringrequirednamestringrequirednominate_bystring | nullrequiredpeer_duestring | nullrequired
personobjectrequired2 fields
idstringrequirednamestringrequired
peopleobject[]required2 fields
personobjectrequired2 fields
idstringrequirednamestringrequired
state"nominated" | "asked"requiredasked: approved (whether they answered or declined is never shown).
countsobject | nullrequiredThe reviewer and HR: how many answered (never who).
2 fields
askedintegerrequiredansweredintegerrequired
minintegerrequiredmaxintegerrequiredfullstring[]requiredPeople already asked for the most peer reviews this cycle (12): pick someone else.
can_nominatebooleanrequiredcan_decidebooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
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"]}'const res = await fetch('https://api.bizisy.com/v1/talent/feedback.nominate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"review_id": "rv1",
"person_ids": [
"p3",
"p4",
"p5"
]
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/feedback.nominate",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"review_id": "rv1",
"person_ids": [
"p3",
"p4",
"p5",
],
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_mineon My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
itemsobject[]required9 fields
idstringrequiredYour request (only you ever see it).
cycleobjectrequired3 fields
idstringrequirednamestringrequiredpeer_duestring | nullrequired
subjectobjectrequired2 fields
idstringrequirednamestringrequired
kind"peer" | "upward"requiredstatus"approved" | "declined" | "submitted" | "withdrawn"requiredsectionsobject[]required5 fields
idstringrequiredtitlestringrequiredtitlesobject4 fields
selfstringmanagerstringpeerstringupwardstring
show_goalsbooleanrequiredquestionsobject[]required6 fields
idstringrequiredtextstringrequiredtextsobjectWording per step (self in the first person); text when absent.
4 fields
selfstringmanagerstringpeerstringupwardstring
kind"rating" | "text" | "both"requiredrequiredbooleanrequiredfor"self" | "manager" | "peer" | "upward"[]required
scaleobjectrequired3 fields
idstringrequirednamestringrequiredpointsobject[]required3 fields
valueintegerrequiredlabelstringrequireddescriptionstringrequired
answersobject[]required3 fields
question_idstringrequiredratinginteger | nullrequiredtextstring | nullrequired
thresholdintegerrequiredAnswers 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 https://api.bizisy.com/v1/talent/feedback.mine \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/talent/feedback.mine', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/feedback.mine",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_answeron My Workplace- Preview
?dry_run=trueruns 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_idstringrequiredanswersobject[]requiredUp to 30 items.
3 fields
question_idstringrequired1–40 characters.
ratinginteger | nullFrom 1 to 7.
textstring | nullUp to 5000 characters.
submitbooleanDefault
false.
Returns
9 fields
idstringrequiredYour request (only you ever see it).
cycleobjectrequired3 fields
idstringrequirednamestringrequiredpeer_duestring | nullrequired
subjectobjectrequired2 fields
idstringrequirednamestringrequired
kind"peer" | "upward"requiredstatus"approved" | "declined" | "submitted" | "withdrawn"requiredsectionsobject[]required5 fields
idstringrequiredtitlestringrequiredtitlesobject4 fields
selfstringmanagerstringpeerstringupwardstring
show_goalsbooleanrequiredquestionsobject[]required6 fields
idstringrequiredtextstringrequiredtextsobjectWording per step (self in the first person); text when absent.
4 fields
selfstringmanagerstringpeerstringupwardstring
kind"rating" | "text" | "both"requiredrequiredbooleanrequiredfor"self" | "manager" | "peer" | "upward"[]required
scaleobjectrequired3 fields
idstringrequirednamestringrequiredpointsobject[]required3 fields
valueintegerrequiredlabelstringrequireddescriptionstringrequired
answersobject[]required3 fields
question_idstringrequiredratinginteger | nullrequiredtextstring | nullrequired
thresholdintegerrequiredAnswers 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 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
}'const res = await fetch('https://api.bizisy.com/v1/talent/feedback.answer', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"feedback_id": "fb1",
"answers": [
{
"question_id": "q1",
"text": "Clear priorities."
}
],
"submit": true
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/feedback.answer",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"feedback_id": "fb1",
"answers": [
{
"question_id": "q1",
"text": "Clear priorities.",
},
],
"submit": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_declineon My Workplace- Preview
?dry_run=trueruns 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
idstringrequiredYour request (only you ever see it).
cycleobjectrequired3 fields
idstringrequirednamestringrequiredpeer_duestring | nullrequired
subjectobjectrequired2 fields
idstringrequirednamestringrequired
kind"peer" | "upward"requiredstatus"approved" | "declined" | "submitted" | "withdrawn"requiredsectionsobject[]required5 fields
idstringrequiredtitlestringrequiredtitlesobject4 fields
selfstringmanagerstringpeerstringupwardstring
show_goalsbooleanrequiredquestionsobject[]required6 fields
idstringrequiredtextstringrequiredtextsobjectWording per step (self in the first person); text when absent.
4 fields
selfstringmanagerstringpeerstringupwardstring
kind"rating" | "text" | "both"requiredrequiredbooleanrequiredfor"self" | "manager" | "peer" | "upward"[]required
scaleobjectrequired3 fields
idstringrequirednamestringrequiredpointsobject[]required3 fields
valueintegerrequiredlabelstringrequireddescriptionstringrequired
answersobject[]required3 fields
question_idstringrequiredratinginteger | nullrequiredtextstring | nullrequired
thresholdintegerrequiredAnswers 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 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"}'const res = await fetch('https://api.bizisy.com/v1/talent/feedback.decline', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"feedback_id": "fb1"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/feedback.decline",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"feedback_id": "fb1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_homeon My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
reviewsobject[]required7 fields
review_idstringrequiredcycleobjectrequired2 fields
idstringrequirednamestringrequired
self"todo" | "done" | "n/a"requiredself_duestring | nullrequiredpeersobject | nullrequiredChoosing peer reviewers, when the cycle has peers.
3 fields
openbooleanrequiredbystring | nullrequiredchosenintegerrequired
release_onstringrequiredreleasedbooleanrequiredtrue once you can read it; false says nothing about its status (only the date).
feedbackobject[]required5 fields
idstringrequiredcycleobjectrequired2 fields
idstringrequirednamestringrequired
subjectobjectrequired2 fields
idstringrequirednamestringrequired
kind"peer" | "upward"requiredduestring | nullrequired
teamobject | nullrequiredManagers: what their team's reviews need from them.
3 fields
to_writeintegerrequiredsignoffsintegerrequirednominationsintegerrequired
goalsobjectrequired2 fields
openintegerrequiredat_riskintegerrequired
profile_promptbooleanrequiredTalent 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 https://api.bizisy.com/v1/talent/me.home \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/talent/me.home', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/me.home",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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.