API reference
1:1s and quarterly check-ins
Regular 1:1s between a person and their manager (cadence, shared agenda, action items, a private note each) and quarterly check-ins (the company's questions, the person's answers, then the manager's). Over a key or AI app, only your own.
33 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
Check-in settings#
POST/v1/org/check_ins.settings.getRead
The company's quarterly check-ins: on or off (off until HR turns them on), the questions (three to start), and whether managers give a 1–5 rating (off by default). Anyone in the company may read them.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_check_ins_settings_geton My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
enabledbooleanrequiredquestionsobject[]required2 fields
idstringrequiredtextstringrequired
ratingbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/check_ins.settings.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/org/check_ins.settings.get', {
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/org/check_ins.settings.get",
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": {
"enabled": true,
"questions": [
{
"id": "q_went_well",
"text": "What went well this quarter?"
}
],
"rating": false
}
}Change check-in settings#
POST/v1/org/check_ins.settings.updateWrite
Turns quarterly check-ins on or off, sets the questions (1 to 10, 300 characters each; keep an id to keep its answers together, omit it for a new question) and the optional 1–5 rating. Answers already given keep the question text they answered. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
org_check_ins_settings_updateon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
enabledbooleanratingbooleanquestionsobject[]1–10 items.
2 fields
idstringUp to 40 characters.
textstringrequired1–300 characters.
Returns
enabledbooleanrequiredquestionsobject[]required2 fields
idstringrequiredtextstringrequired
ratingbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/check_ins.settings.update \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"enabled": true,
"rating": true,
"questions": [
{
"id": "q_went_well",
"text": "What went well?"
},
{
"text": "What next?"
}
]
}'const res = await fetch('https://api.bizisy.com/v1/org/check_ins.settings.update', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"enabled": true,
"rating": true,
"questions": [
{
"id": "q_went_well",
"text": "What went well?"
},
{
"text": "What next?"
}
]
}),
});
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/org/check_ins.settings.update",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"enabled": True,
"rating": True,
"questions": [
{
"id": "q_went_well",
"text": "What went well?",
},
{
"text": "What next?",
},
],
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"enabled": true,
"questions": [
{
"id": "q_went_well",
"text": "What went well this quarter?"
}
],
"rating": true
}
}A quarterly check-in#
POST/v1/org/check_ins.getRead
A person's check-in for a quarter (period like 2026-Q4; default the one open now): its window (opens 14 days before the quarter ends, due 14 days after; it stays open, overdue, until the next one opens), the questions, and the answers you may see — the person sees their own always and the manager's once submitted; the manager the reverse; higher managers and HR once submitted. can_answer says which side you answer for while it is open. Colleagues never; API keys and AI apps only your own.
- Who can call it
- Manage key any Manage role
Me key anyone - Keys and apps
- Only your own quarterly check-in.
- MCP tool
org_check_ins_geton My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
person_idstringrequiredWhose 1:1 (the person; their manager today is the other side).
periodstringPattern
^\d{4}-Q[1-4]$.
Returns
13 fields
periodstringrequiredopensstringrequiredduestringrequiredopenbooleanrequiredThe latest check-in to open: answers can be given until the next one opens.
overduebooleanrequiredPast its due day and not yet answered by both.
personobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
questionsobject[]required2 fields
idstringrequiredtextstringrequired
ratingbooleanrequiredThe company asks the manager for a 1–5 rating.
selfobject | nullrequiredThe person's answers: the person always; others once submitted.
3 fields
answersobject[]required3 fields
question_idstringrequiredquestionstringrequiredtextstringrequired
ratinginteger | nullrequiredsubmitted_atstring | nullrequired
manager_answersobject | nullrequiredThe manager's answers: the manager always; others once submitted.
3 fields
answersobject[]required3 fields
question_idstringrequiredquestionstringrequiredtextstringrequired
ratinginteger | nullrequiredsubmitted_atstring | nullrequired
can_answer"person" | "manager"requiredenabledbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/check_ins.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_id":"p3","period":"2026-Q3"}'const res = await fetch('https://api.bizisy.com/v1/org/check_ins.get', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"person_id": "p3",
"period": "2026-Q3"
}),
});
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/org/check_ins.get",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"person_id": "p3",
"period": "2026-Q3",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"period": "2026-Q3",
"opens": "2026-09-17",
"due": "2026-10-14",
"open": true,
"overdue": false,
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"questions": [
{
"id": "q_went_well",
"text": "What went well this quarter?"
}
],
"rating": false,
"self": {
"answers": [
{
"question_id": "q_went_well",
"question": "What went well this quarter?",
"text": "Shipped the new onboarding."
}
],
"rating": null,
"submitted_at": null
},
"manager_answers": null,
"can_answer": "person",
"enabled": true
}
}Answer a check-in#
POST/v1/org/check_ins.answerWrite
Saves your answers to a person's check-in while it is open: as the person (your own) or as their manager today. submit true makes them visible to the other side, higher managers and HR (no changes after). rating (1–5) only from the manager, and only when the company asks for it. 4000 characters per answer. Over an API key or AI app, only the person's own.
- Who can call it
- Manage key any Manage role
Me key anyone - Keys and apps
- Only your own answers.
- MCP tool
org_check_ins_answeron My Workplace, HR Assistant- 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
person_idstringrequiredWhose 1:1 (the person; their manager today is the other side).
periodstringrequiredPattern
^\d{4}-Q[1-4]$.answersobject[]requiredUp to 10 items.
2 fields
question_idstringrequiredtextstringrequiredUp to 4000 characters.
ratinginteger | nullFrom 1 to 5.
submittrue
Returns
12 fields
periodstringrequiredopensstringrequiredduestringrequiredopenbooleanrequiredThe latest check-in to open: answers can be given until the next one opens.
overduebooleanrequiredPast its due day and not yet answered by both.
personobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
questionsobject[]required2 fields
idstringrequiredtextstringrequired
ratingbooleanrequiredThe company asks the manager for a 1–5 rating.
selfobject | nullrequiredThe person's answers: the person always; others once submitted.
3 fields
answersobject[]required3 fields
question_idstringrequiredquestionstringrequiredtextstringrequired
ratinginteger | nullrequiredsubmitted_atstring | nullrequired
manager_answersobject | nullrequiredThe manager's answers: the manager always; others once submitted.
3 fields
answersobject[]required3 fields
question_idstringrequiredquestionstringrequiredtextstringrequired
ratinginteger | nullrequiredsubmitted_atstring | nullrequired
can_answer"person" | "manager"required
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/check_ins.answer \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"person_id": "p3",
"period": "2026-Q3",
"answers": [
{
"question_id": "q_went_well",
"text": "Shipped it"
}
],
"rating": 4,
"submit": true
}'const res = await fetch('https://api.bizisy.com/v1/org/check_ins.answer', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"person_id": "p3",
"period": "2026-Q3",
"answers": [
{
"question_id": "q_went_well",
"text": "Shipped it"
}
],
"rating": 4,
"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/org/check_ins.answer",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"person_id": "p3",
"period": "2026-Q3",
"answers": [
{
"question_id": "q_went_well",
"text": "Shipped it",
},
],
"rating": 4,
"submit": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"period": "2026-Q3",
"opens": "2026-09-17",
"due": "2026-10-14",
"open": true,
"overdue": false,
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"questions": [
{
"id": "q_went_well",
"text": "What went well this quarter?"
}
],
"rating": false,
"self": {
"answers": [
{
"question_id": "q_went_well",
"question": "What went well this quarter?",
"text": "Shipped the new onboarding."
}
],
"rating": null,
"submitted_at": null
},
"manager_answers": null,
"can_answer": "person"
}
}Check-ins across the company#
POST/v1/org/check_ins.listRead
For owners, admins and HR: everyone working here with a manager, with their 1:1 (cadence, last held, next date) and the quarter's check-in state (not started, the person answered, the manager answered, both). Never the answers, notes or agenda (open each one). Signed in only.
- Who can call it
- Manage key owner admin hr
- MCP tool
org_check_ins_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
periodstringPattern
^\d{4}-Q[1-4]$.
Returns
periodstringrequiredenabledbooleanrequiredrowsobject[]required5 fields
personobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
one_on_oneobject | nullrequired3 fields
cadence"weekly" | "biweekly" | "monthly"requiredlast_heldstring | nullrequirednext_datestring | nullrequired
self_submittedbooleanrequiredmanager_submittedbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/check_ins.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"period":"2026-Q3"}'const res = await fetch('https://api.bizisy.com/v1/org/check_ins.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"period": "2026-Q3"
}),
});
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/org/check_ins.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"period": "2026-Q3",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"period": "2026-Q3",
"enabled": true,
"rows": [
{
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"one_on_one": {
"cadence": "weekly",
"last_held": "2026-09-29",
"next_date": "2026-10-06"
},
"self_submitted": false,
"manager_submitted": false
}
]
}
}Prepare a 1:1 or check-in#
POST/v1/org/check_ins.prepareRead
Everything to prepare the next 1:1 of a person with their manager, or their check-in, for you to summarise: the next meeting's topics, open action items (overdue marked), what was discussed at the last three 1:1s (topics and shared notes), your own private notes from the last 90 days (only yours), the open check-in's answers you may see, and time off in the last 90 days as you may see it (dates and days; the type only where you see it). The person and their manager; higher managers and HR without notes. Over an API key or AI app, the person's own only.
- Who can call it
- Manage key any Manage role
Me key anyone - Keys and apps
- Only your own 1:1 and check-in.
- MCP tool
org_check_ins_prepareon My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
person_idstringrequiredWhose 1:1 (the person; their manager today is the other side).
Returns
10 fields
personobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
role"person" | "manager" | "chain" | "hr"requiredseries_idstring | nullrequirednext_datestring | nullrequiredtopicsobject[]required3 fields
textstringrequiredby"person" | "manager"requiredcarried_fromstring | nullrequired
open_actionsobject[]required4 fields
textstringrequiredowner"person" | "manager"requiredduestring | nullrequiredoverduebooleanrequired
recentobject[]required2 fields
datestringrequiredpointsobject[]required2 fields
textstringrequirednotesstringrequired
my_notesobject[]required2 fields
datestringrequiredtextstringrequired
check_inobject | nullrequired12 fields
periodstringrequiredopensstringrequiredduestringrequiredopenbooleanrequiredThe latest check-in to open: answers can be given until the next one opens.
overduebooleanrequiredPast its due day and not yet answered by both.
personobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
questionsobject[]required2 fields
idstringrequiredtextstringrequired
ratingbooleanrequiredThe company asks the manager for a 1–5 rating.
selfobject | nullrequiredThe person's answers: the person always; others once submitted.
3 fields
answersobject[]required3 fields
question_idstringrequiredquestionstringrequiredtextstringrequired
ratinginteger | nullrequiredsubmitted_atstring | nullrequired
manager_answersobject | nullrequiredThe manager's answers: the manager always; others once submitted.
3 fields
answersobject[]required3 fields
question_idstringrequiredquestionstringrequiredtextstringrequired
ratinginteger | nullrequiredsubmitted_atstring | nullrequired
can_answer"person" | "manager"required
time_offobject[]required4 fields
startstringrequiredendstringrequireddaysnumberrequiredtypestring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/check_ins.prepare \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_id":"p3"}'const res = await fetch('https://api.bizisy.com/v1/org/check_ins.prepare', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"person_id": "p3"
}),
});
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/org/check_ins.prepare",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"person_id": "p3",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"role": "manager",
"series_id": "o1:p3:p2",
"next_date": "2026-10-06",
"topics": [
{
"text": "Training budget",
"by": "person",
"carried_from": null
}
],
"open_actions": [
{
"text": "Draft the research plan",
"owner": "person",
"due": "2026-10-02",
"overdue": true
}
],
"recent": [
{
"date": "2026-09-29",
"points": [
{
"text": "Holidays",
"notes": "Off next week."
}
]
}
],
"my_notes": [],
"check_in": {
"period": "2026-Q3",
"opens": "2026-09-17",
"due": "2026-10-14",
"open": true,
"overdue": false,
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"questions": [
{
"id": "q_went_well",
"text": "What went well this quarter?"
}
],
"rating": false,
"self": {
"answers": [
{
"question_id": "q_went_well",
"question": "What went well this quarter?",
"text": "Shipped the new onboarding."
}
],
"rating": null,
"submitted_at": null
},
"manager_answers": null,
"can_answer": "person"
},
"time_off": []
}
}My 1:1s#
POST/v1/org/one_on_ones.mineRead
Your 1:1s: with your manager, dotted-line managers and skip-levels (as the person), and as a manager each direct report with their 1:1 or none yet, plus nudges (reports without a regular 1:1, or none held in 30 days; exempt people left out) and the quarterly check-in open now. Next meeting, last held, topics and action items counted. Machines get your own only.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_mineon My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
7 fields
todaystringrequiredmanagerobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
with_managersobject[]requiredYour 1:1s as the person: with your manager, dotted-line managers, skip-levels.
14 fields
idstringrequiredkind"manager" | "dotted" | "skip"requiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
cadence"weekly" | "biweekly" | "monthly"requiredfirst_datestringrequiredtimestring | nullrequiredlengthintegerrequiredtemplate_idstring | nullrequiredlivebooleanrequiredThe two are still in this relationship and it was not stopped.
nextobject | nullrequired6 fields
idstringrequireddatestringrequiredtimestring | nullrequiredstatus"planned" | "in_progress" | "held" | "skipped"requiredtopicsintegerrequiredcarriedintegerrequired
last_heldstring | nullrequiredopen_actionsintegerrequiredoverdue_actionsintegerrequired
reportsobject[]required5 fields
personobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
seriesobject | nullrequired14 fields
idstringrequiredkind"manager" | "dotted" | "skip"requiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
cadence"weekly" | "biweekly" | "monthly"requiredfirst_datestringrequiredtimestring | nullrequiredlengthintegerrequiredtemplate_idstring | nullrequiredlivebooleanrequiredThe two are still in this relationship and it was not stopped.
nextobject | nullrequired6 fields
idstringrequireddatestringrequiredtimestring | nullrequiredstatus"planned" | "in_progress" | "held" | "skipped"requiredtopicsintegerrequiredcarriedintegerrequired
last_heldstring | nullrequiredopen_actionsintegerrequiredoverdue_actionsintegerrequired
exemptbooleanrequirednudge"none" | "no_series" | "not_held"requiredno_series: no regular 1:1; not_held: none held in 30 days.
check_inobject | nullrequired2 fields
self_submittedbooleanrequiredmanager_submittedbooleanrequired
othersobject[]requiredYour skip-level and dotted-line 1:1s as the manager.
14 fields
idstringrequiredkind"manager" | "dotted" | "skip"requiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
cadence"weekly" | "biweekly" | "monthly"requiredfirst_datestringrequiredtimestring | nullrequiredlengthintegerrequiredtemplate_idstring | nullrequiredlivebooleanrequiredThe two are still in this relationship and it was not stopped.
nextobject | nullrequired6 fields
idstringrequireddatestringrequiredtimestring | nullrequiredstatus"planned" | "in_progress" | "held" | "skipped"requiredtopicsintegerrequiredcarriedintegerrequired
last_heldstring | nullrequiredopen_actionsintegerrequiredoverdue_actionsintegerrequired
check_inobject | nullrequired5 fields
periodstringrequiredopensstringrequiredduestringrequiredself_submittedbooleanrequiredmanager_submittedbooleanrequired
can_skip_levelsbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.mine \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.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/org/one_on_ones.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": {
"today": "2026-10-04",
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"with_managers": [
{
"id": "o1:p3:p2",
"kind": "manager",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"cadence": "weekly",
"first_date": "2026-09-08",
"time": "10:00",
"length": 30,
"template_id": null,
"live": true,
"next": {
"id": "m2",
"date": "2026-10-06",
"time": "10:00",
"status": "planned",
"topics": 2,
"carried": 1
},
"last_held": "2026-09-29",
"open_actions": 2,
"overdue_actions": 1
}
],
"reports": [
{
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"series": {
"id": "o1:p3:p2",
"kind": "manager",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"cadence": "weekly",
"first_date": "2026-09-08",
"time": "10:00",
"length": 30,
"template_id": null,
"live": true,
"next": {
"id": "m2",
"date": "2026-10-06",
"time": "10:00",
"status": "planned",
"topics": 2,
"carried": 1
},
"last_held": "2026-09-29",
"open_actions": 2,
"overdue_actions": 1
},
"exempt": false,
"nudge": "none",
"check_in": {
"self_submitted": false,
"manager_submitted": false
}
}
],
"others": [],
"check_in": {
"period": "2026-Q3",
"opens": "2026-09-17",
"due": "2026-10-14",
"self_submitted": false,
"manager_submitted": false
},
"can_skip_levels": true
}
}A 1:1#
POST/v1/org/one_on_ones.getRead
One 1:1 series: its rhythm, the next meeting (date, status, its topics in order with shared notes and outcome, the template's prompts), the pair's open action items (and done in the last 30 days), your own private note for the next meeting (only you ever see it), what happened since the last one (time off as you may see it, the open quarterly check-in), and how many meetings are in the history. The two people in it change it; the person's higher managers (direct-manager 1:1s only) and owners, admins and HR can read it; colleagues never. API keys and AI apps only for the person themself.
- Who can call it
- Manage key any Manage role
Me key anyone - Keys and apps
- Only your own 1:1 with your manager; a manager's side stays in Bizisy.
- MCP tool
org_one_on_ones_geton My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
series_idstringThe 1:1 series (from
org_one_on_ones_mine).person_idstringOr a person: their 1:1 with their manager today.
Returns
11 fields
todaystringrequiredrole"person" | "manager" | "chain" | "hr"requiredseriesobjectrequired14 fields
idstringrequiredkind"manager" | "dotted" | "skip"requiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
cadence"weekly" | "biweekly" | "monthly"requiredfirst_datestringrequiredtimestring | nullrequiredlengthintegerrequiredtemplate_idstring | nullrequiredlivebooleanrequiredThe two are still in this relationship and it was not stopped.
nextobject | nullrequired6 fields
idstringrequireddatestringrequiredtimestring | nullrequiredstatus"planned" | "in_progress" | "held" | "skipped"requiredtopicsintegerrequiredcarriedintegerrequired
last_heldstring | nullrequiredopen_actionsintegerrequiredoverdue_actionsintegerrequired
meetingobject | nullrequired9 fields
idstringrequireddatestringrequiredtimestring | nullrequiredstatus"planned" | "in_progress" | "held" | "skipped"requiredmoved_fromstring | nullrequiredstarted_atstring | nullrequiredfinished_atstring | nullrequiredtemplateobject | nullrequired4 fields
idstringrequirednamestringrequiredpromptsstring[]requiredstarterbooleanrequired
topicsobject[]required10 fields
idstringrequiredtextstringrequiredtag"recognition" | "priorities" | "blocker" | "growth" | "check_in"requiredby"person" | "manager"requiredminebooleanrequiredpositionnumberrequiredoutcome"done" | "next_time"requirednotesstringrequirednotes_vintegerrequiredcarried_fromstring | nullrequiredThe 1:1 date it was moved on from ("from last time").
actionsobject[]required10 fields
idstringrequiredtextstringrequiredowner"person" | "manager"requiredowner_personobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
by"person" | "manager"requiredminebooleanrequiredduestring | nullrequireddone_onstring | nullrequiredoverduebooleanrequiredfrom_datestring | nullrequiredThe 1:1 it came from.
my_notestring | nullrequiredYour private note for this meeting (the two people only).
my_rating"useful" | "ok" | "not_really"requiredsinceobjectrequired3 fields
last_heldstring | nullrequireddays_offnumber | nullrequiredWorking days off since the last 1:1, as you may see them; null when unknown.
check_inobject | nullrequired4 fields
periodstringrequiredduestringrequiredself_submittedbooleanrequiredmanager_submittedbooleanrequired
history_countintegerrequiredtemplatesobject[]required4 fields
idstringrequirednamestringrequiredpromptsstring[]requiredstarterbooleanrequired
exemptbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"series_id":"org-acme:p2:p1"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.get', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"series_id": "org-acme:p2:p1"
}),
});
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/org/one_on_ones.get",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"series_id": "org-acme:p2:p1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"today": "2026-10-04",
"role": "person",
"series": {
"id": "o1:p3:p2",
"kind": "manager",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"cadence": "weekly",
"first_date": "2026-09-08",
"time": "10:00",
"length": 30,
"template_id": null,
"live": true,
"next": {
"id": "m2",
"date": "2026-10-06",
"time": "10:00",
"status": "planned",
"topics": 2,
"carried": 1
},
"last_held": "2026-09-29",
"open_actions": 2,
"overdue_actions": 1
},
"meeting": {
"id": "m2",
"date": "2026-10-06",
"time": "10:00",
"status": "planned",
"moved_from": null,
"started_at": null,
"finished_at": null,
"template": {
"id": "tpl_weekly",
"name": "Weekly 1:1",
"prompts": [
"What are your top 3 priorities this week?",
"Is anything blocking you?"
],
"starter": true
},
"topics": [
{
"id": "t1",
"text": "Training budget for next year",
"tag": "growth",
"by": "person",
"mine": true,
"position": 1,
"outcome": null,
"notes": "",
"notes_v": 0,
"carried_from": "2026-09-29"
}
]
},
"actions": [
{
"id": "a1",
"text": "Draft the research plan",
"owner": "person",
"owner_person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"by": "manager",
"mine": false,
"due": "2026-10-02",
"done_on": null,
"overdue": true,
"from_date": "2026-09-29"
}
],
"my_note": "Mention the conference",
"my_rating": null,
"since": {
"last_held": "2026-09-29",
"days_off": 3,
"check_in": {
"period": "2026-Q3",
"due": "2026-10-14",
"self_submitted": false,
"manager_submitted": false
}
},
"history_count": 4,
"templates": [
{
"id": "tpl_weekly",
"name": "Weekly 1:1",
"prompts": [
"What are your top 3 priorities this week?",
"Is anything blocking you?"
],
"starter": true
}
],
"exempt": false
}
}A 1:1's history#
POST/v1/org/one_on_ones.historyRead
The held (and skipped) meetings of a 1:1, newest first (up to 50, before a date to page): per meeting its topics with their shared notes and outcome, the action items it created with their status now, what moved on to the next one, and its length. Private notes and ratings are never here. The two people in it change it; the person's higher managers (direct-manager 1:1s only) and owners, admins and HR can read it; colleagues never. API keys and AI apps only for the person themself.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_historyon My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
series_idstringThe 1:1 series (from
org_one_on_ones_mine).person_idstringOr a person: their 1:1 with their manager today.
beforestringlimitintegerFrom 1 to 50. Default
20.
Returns
itemsobject[]required7 fields
idstringrequireddatestringrequiredstatus"held" | "skipped"requiredminutesinteger | nullrequiredtopicsobject[]required10 fields
idstringrequiredtextstringrequiredtag"recognition" | "priorities" | "blocker" | "growth" | "check_in"requiredby"person" | "manager"requiredminebooleanrequiredpositionnumberrequiredoutcome"done" | "next_time"requirednotesstringrequirednotes_vintegerrequiredcarried_fromstring | nullrequiredThe 1:1 date it was moved on from ("from last time").
actionsobject[]required10 fields
idstringrequiredtextstringrequiredowner"person" | "manager"requiredowner_personobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
by"person" | "manager"requiredminebooleanrequiredduestring | nullrequireddone_onstring | nullrequiredoverduebooleanrequiredfrom_datestring | nullrequiredThe 1:1 it came from.
carriedstring[]required
morebooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.history \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"series_id":"org-acme:p2:p1","before":"2026-09-01","limit":10}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.history', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"series_id": "org-acme:p2:p1",
"before": "2026-09-01",
"limit": 10
}),
});
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/org/one_on_ones.history",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"series_id": "org-acme:p2:p1",
"before": "2026-09-01",
"limit": 10,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"id": "m1",
"date": "2026-09-29",
"status": "held",
"minutes": 28,
"topics": [
{
"id": "t0",
"text": "Training budget for next year",
"tag": "growth",
"by": "person",
"mine": true,
"position": 1,
"outcome": "done",
"notes": "Agreed on the plan.",
"notes_v": 0,
"carried_from": null
}
],
"actions": [
{
"id": "a1",
"text": "Draft the research plan",
"owner": "person",
"owner_person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"by": "manager",
"mine": false,
"due": "2026-10-02",
"done_on": null,
"overdue": true,
"from_date": "2026-09-29"
}
],
"carried": [
"Training budget for next year"
]
}
],
"more": false
}
}My 1:1 action items#
POST/v1/org/one_on_ones.my_actionsRead
The action items you own across all your 1:1s, open first (and done in the last 14 days), with whom the 1:1 is and its due date: what My tasks and Home show. Yours only.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_my_actionson My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
itemsobject[]required12 fields
idstringrequiredtextstringrequiredowner"person" | "manager"requiredowner_personobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
by"person" | "manager"requiredminebooleanrequiredduestring | nullrequireddone_onstring | nullrequiredoverduebooleanrequiredfrom_datestring | nullrequiredThe 1:1 it came from.
series_idstringrequiredwithobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
overdueintegerrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.my_actions \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.my_actions', {
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/org/one_on_ones.my_actions",
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": "a1",
"text": "Draft the research plan",
"owner": "person",
"owner_person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"by": "manager",
"mine": false,
"due": "2026-10-02",
"done_on": null,
"overdue": true,
"from_date": "2026-09-29",
"series_id": "o1:p3:p2",
"with": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
}
}
],
"overdue": 1
}
}Start or change a 1:1#
POST/v1/org/one_on_ones.startWrite
Starts a regular 1:1, or changes its rhythm: kind manager (the person and their manager today; either of them or HR), dotted (with a dotted-line manager today; either of them or HR) or skip (a manager above the direct manager, when the company allows skip-levels; that manager or HR; the manager in between is told). cadence weekly, biweekly or monthly; first_date; optional time (HH:MM) and length (15, 30, 45, 60 minutes); optional template. Up to 20 1:1s per person.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_starton My Workplace, HR Assistant- 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
person_idstringrequiredkind"manager" | "dotted" | "skip"Default
"manager".with_idstringdotted or skip: the manager side (default: you).
cadence"weekly" | "biweekly" | "monthly"requiredfirst_datestringrequiredtimestring | nullPattern
^([01]\d|2[0-3]):[0-5]\d$.lengthintegertemplate_idstring | null
Returns
14 fields
idstringrequiredkind"manager" | "dotted" | "skip"requiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
cadence"weekly" | "biweekly" | "monthly"requiredfirst_datestringrequiredtimestring | nullrequiredlengthintegerrequiredtemplate_idstring | nullrequiredlivebooleanrequiredThe two are still in this relationship and it was not stopped.
nextobject | nullrequired6 fields
idstringrequireddatestringrequiredtimestring | nullrequiredstatus"planned" | "in_progress" | "held" | "skipped"requiredtopicsintegerrequiredcarriedintegerrequired
last_heldstring | nullrequiredopen_actionsintegerrequiredoverdue_actionsintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.start \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"person_id": "p3",
"kind": "skip",
"with_id": "p1",
"cadence": "monthly",
"first_date": "2026-10-07",
"length": 30,
"template_id": "tpl_skip"
}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.start', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"person_id": "p3",
"kind": "skip",
"with_id": "p1",
"cadence": "monthly",
"first_date": "2026-10-07",
"length": 30,
"template_id": "tpl_skip"
}),
});
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/org/one_on_ones.start",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"person_id": "p3",
"kind": "skip",
"with_id": "p1",
"cadence": "monthly",
"first_date": "2026-10-07",
"length": 30,
"template_id": "tpl_skip",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "o1:p3:p2",
"kind": "skip",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"cadence": "monthly",
"first_date": "2026-10-07",
"time": "10:00",
"length": 30,
"template_id": null,
"live": true,
"next": {
"id": "m2",
"date": "2026-10-06",
"time": "10:00",
"status": "planned",
"topics": 2,
"carried": 1
},
"last_held": "2026-09-29",
"open_actions": 2,
"overdue_actions": 1
}
}Set up 1:1s for my team#
POST/v1/org/one_on_ones.setup_teamWrite
For a manager: starts a regular 1:1 with each direct report who has none (and is not exempt), with the company's usual rhythm, from the next working week, on the day given (default Tuesday) and time. Returns how many were set up. In the app only.
- Web app only
- Refused for API keys and connected apps. A manager sets up their team's 1:1s in the Bizisy app.
- MCP tool
org_one_on_ones_setup_teamon My Workplace, HR Assistant- 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
weekdayinteger1 Monday … 5 Friday.
From 1 to 5. Default
2.timestring | nullPattern
^([01]\d|2[0-3]):[0-5]\d$.
Returns
startedintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.setup_team \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"weekday":2,"time":"10:00"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.setup_team', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"weekday": 2,
"time": "10:00"
}),
});
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/org/one_on_ones.setup_team",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"weekday": 2,
"time": "10:00",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"started": 2
}
}Stop a 1:1#
POST/v1/org/one_on_ones.endWrite
Stops a regular 1:1 (no more meetings, reminders or invites); its history stays. Either of the two, or owners, admins and HR. Start it again any time.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_endon My Workplace, HR Assistant- 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
series_idstringThe 1:1 series (from
org_one_on_ones_mine).person_idstringOr a person: their 1:1 with their manager today.
Returns
endedbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.end \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"series_id":"org-acme:p2:p1"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.end', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"series_id": "org-acme:p2:p1"
}),
});
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/org/one_on_ones.end",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"series_id": "org-acme:p2:p1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"ended": true
}
}Add a topic to a 1:1#
POST/v1/org/one_on_ones.add_topicWrite
Adds something to talk about to the next meeting of a 1:1 (both people add; 50 per meeting, 500 characters), with an optional tag (recognition, priorities, blocker, growth, check_in). Shared between the two (their higher managers and HR can read it). Never put health details here.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_add_topicon My Workplace, HR Assistant- 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
series_idstringThe 1:1 series (from
org_one_on_ones_mine).person_idstringOr a person: their 1:1 with their manager today.
textstringrequired1–500 characters.
tag"recognition" | "priorities" | "blocker" | "growth" | "check_in"
Returns
10 fields
idstringrequiredtextstringrequiredtag"recognition" | "priorities" | "blocker" | "growth" | "check_in"requiredby"person" | "manager"requiredminebooleanrequiredpositionnumberrequiredoutcome"done" | "next_time"requirednotesstringrequirednotes_vintegerrequiredcarried_fromstring | nullrequiredThe 1:1 date it was moved on from ("from last time").
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.add_topic \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"series_id": "org-acme:p2:p1",
"text": "Blocked on recruitment",
"tag": "blocker"
}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.add_topic', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"series_id": "org-acme:p2:p1",
"text": "Blocked on recruitment",
"tag": "blocker"
}),
});
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/org/one_on_ones.add_topic",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"series_id": "org-acme:p2:p1",
"text": "Blocked on recruitment",
"tag": "blocker",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "t1",
"text": "Blocked on recruitment",
"tag": "blocker",
"by": "person",
"mine": true,
"position": 1,
"outcome": null,
"notes": "",
"notes_v": 0,
"carried_from": "2026-09-29"
}
}Change a 1:1 topic#
POST/v1/org/one_on_ones.update_topicWrite
Changes a topic of a meeting that is not finished: its text or tag (whoever added it), its place (either: position, 1 = first), or removes it (whoever added it). The two people in the 1:1 only.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_update_topicon My Workplace, HR Assistant- 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
topic_idstringrequiredtextstring1–500 characters.
tag"recognition" | "priorities" | "blocker" | "growth" | "check_in"positionintegerFrom 1 to 50.
removetrue
Returns
topicobject | nullrequired10 fields
idstringrequiredtextstringrequiredtag"recognition" | "priorities" | "blocker" | "growth" | "check_in"requiredby"person" | "manager"requiredminebooleanrequiredpositionnumberrequiredoutcome"done" | "next_time"requirednotesstringrequirednotes_vintegerrequiredcarried_fromstring | nullrequiredThe 1:1 date it was moved on from ("from last time").
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.update_topic \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"topic_id":"t9","text":"Training budget 2027","tag":null}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.update_topic', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"topic_id": "t9",
"text": "Training budget 2027",
"tag": null
}),
});
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/org/one_on_ones.update_topic",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"topic_id": "t9",
"text": "Training budget 2027",
"tag": None,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"topic": {
"id": "t1",
"text": "Training budget for next year",
"tag": "growth",
"by": "person",
"mine": true,
"position": 1,
"outcome": null,
"notes": "",
"notes_v": 0,
"carried_from": "2026-09-29"
}
}
}Start a 1:1 meeting#
POST/v1/org/one_on_ones.start_meetingWrite
Starts the 1:1 meeting now (it may be its planned day or not): the two then go through its topics one by one. Either of the two people, in the app only.
- Web app only
- Refused for API keys and connected apps. The two people hold the meeting in the Bizisy app.
- MCP tool
org_one_on_ones_start_meetingon My Workplace, HR Assistant- 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
meeting_idstringrequired
Returns
idstringrequiredstatus"in_progress"requiredstarted_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.start_meeting \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"meeting_id":"m-p2-p1"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.start_meeting', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"meeting_id": "m-p2-p1"
}),
});
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/org/one_on_ones.start_meeting",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"meeting_id": "m-p2-p1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "m2",
"status": "in_progress",
"started_at": "2026-10-06T08:02:00.000Z"
}
}Notes and outcome of a 1:1 topic#
POST/v1/org/one_on_ones.discussWrite
Saves a topic's shared notes (5000 characters) and/or its outcome in the meeting (done, next_time to move it on to the next 1:1, or null to undo). Send notes_v (the version you saw; required with notes): if the other person saved meanwhile, it is refused with their latest text so nothing is overwritten. The two people only.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_discusson My Workplace, HR Assistant- 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
topic_idstringrequirednotesstringUp to 5000 characters.
notes_vintegerAt least 0.
outcome"done" | "next_time"
Returns
10 fields
idstringrequiredtextstringrequiredtag"recognition" | "priorities" | "blocker" | "growth" | "check_in"requiredby"person" | "manager"requiredminebooleanrequiredpositionnumberrequiredoutcome"done" | "next_time"requirednotesstringrequirednotes_vintegerrequiredcarried_fromstring | nullrequiredThe 1:1 date it was moved on from ("from last time").
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.discuss \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"topic_id":"t9","notes":"Agreed","notes_v":0,"outcome":"done"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.discuss', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"topic_id": "t9",
"notes": "Agreed",
"notes_v": 0,
"outcome": "done"
}),
});
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/org/one_on_ones.discuss",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"topic_id": "t9",
"notes": "Agreed",
"notes_v": 0,
"outcome": "done",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "t1",
"text": "Training budget for next year",
"tag": "growth",
"by": "person",
"mine": true,
"position": 1,
"outcome": "done",
"notes": "Agreed",
"notes_v": 0,
"carried_from": "2026-09-29"
}
}Finish a 1:1 meeting#
POST/v1/org/one_on_ones.finishWrite
Finishes a 1:1 meeting: it is held (today, or its date when earlier), topics not done move on to the next meeting (marked "from last time"), the next meeting is planned (on next_date/next_time when given, else from the rhythm), and the other person is told the summary is ready. Either of the two people, in the app only.
- Web app only
- Refused for API keys and connected apps. The two people wrap up the meeting in the Bizisy app.
- MCP tool
org_one_on_ones_finishon My Workplace, HR Assistant- 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
meeting_idstringrequirednext_datestringnext_timestring | nullPattern
^([01]\d|2[0-3]):[0-5]\d$.
Returns
held_onstringrequirednextobject | nullrequired3 fields
idstringrequireddatestringrequiredtimestring | nullrequired
carriedintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.finish \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"meeting_id":"m-p2-p1","next_date":"2026-10-14","next_time":"11:00"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.finish', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"meeting_id": "m-p2-p1",
"next_date": "2026-10-14",
"next_time": "11:00"
}),
});
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/org/one_on_ones.finish",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"meeting_id": "m-p2-p1",
"next_date": "2026-10-14",
"next_time": "11:00",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"held_on": "2026-10-06",
"next": {
"id": "m3",
"date": "2026-10-13",
"time": "10:00"
},
"carried": 1
}
}Move or skip a 1:1 meeting#
POST/v1/org/one_on_ones.moveWrite
Moves the next 1:1 meeting to another date (and time), or skips it (skip true: its topics move to the one after, which is planned from the rhythm). Only that meeting changes; the rhythm stays. Either of the two people.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_moveon My Workplace, HR Assistant- 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
meeting_idstringrequireddatestringtimestring | nullPattern
^([01]\d|2[0-3]):[0-5]\d$.skiptrue
Returns
nextobject | nullrequired3 fields
idstringrequireddatestringrequiredtimestring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.move \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"meeting_id":"m-p2-p1","date":"2026-10-07"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.move', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"meeting_id": "m-p2-p1",
"date": "2026-10-07"
}),
});
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/org/one_on_ones.move",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"meeting_id": "m-p2-p1",
"date": "2026-10-07",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"next": {
"id": "m2",
"date": "2026-10-07",
"time": "10:00"
}
}
}Add a 1:1 action item#
POST/v1/org/one_on_ones.add_actionWrite
Adds an action item to a 1:1: owner person or manager (who does it), optional due date, optional topic it came from. It shows in the owner's My tasks and Home until done; the other person is told when it is theirs. 50 per meeting, 500 characters. The two people only.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_add_actionon My Workplace, HR Assistant- 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
series_idstringThe 1:1 series (from
org_one_on_ones_mine).person_idstringOr a person: their 1:1 with their manager today.
textstringrequired1–500 characters.
owner"person" | "manager"duestring | nulltopic_idstring
Returns
10 fields
idstringrequiredtextstringrequiredowner"person" | "manager"requiredowner_personobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
by"person" | "manager"requiredminebooleanrequiredduestring | nullrequireddone_onstring | nullrequiredoverduebooleanrequiredfrom_datestring | nullrequiredThe 1:1 it came from.
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.add_action \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"series_id": "org-acme:p2:p1",
"text": "Share the course list",
"owner": "manager",
"due": "2026-10-10"
}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.add_action', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"series_id": "org-acme:p2:p1",
"text": "Share the course list",
"owner": "manager",
"due": "2026-10-10"
}),
});
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/org/one_on_ones.add_action",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"series_id": "org-acme:p2:p1",
"text": "Share the course list",
"owner": "manager",
"due": "2026-10-10",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "a2",
"text": "Share the course list",
"owner": "manager",
"owner_person": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"by": "manager",
"mine": true,
"due": "2026-10-10",
"done_on": null,
"overdue": false,
"from_date": "2026-09-29"
}
}Change a 1:1 action item#
POST/v1/org/one_on_ones.update_itemWrite
Changes an action item of a 1:1: done true/false (either of the two; from the 1:1, My tasks or Home), text or remove (whoever added it, while open), due date or owner (either). The two people only.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_update_itemon My Workplace, HR Assistant- 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
item_idstringrequiredtextstring1–500 characters.
donebooleanduestring | nullowner"person" | "manager"removetrue
Returns
itemobject | nullrequired10 fields
idstringrequiredtextstringrequiredowner"person" | "manager"requiredowner_personobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
by"person" | "manager"requiredminebooleanrequiredduestring | nullrequireddone_onstring | nullrequiredoverduebooleanrequiredfrom_datestring | nullrequiredThe 1:1 it came from.
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.update_item \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"item_id": "a5",
"text": "Draft it",
"due": null,
"owner": "person",
"remove": true
}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.update_item', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"item_id": "a5",
"text": "Draft it",
"due": null,
"owner": "person",
"remove": 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/org/one_on_ones.update_item",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"item_id": "a5",
"text": "Draft it",
"due": None,
"owner": "person",
"remove": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"item": {
"id": "a1",
"text": "Draft the research plan",
"owner": "person",
"owner_person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"by": "manager",
"mine": false,
"due": "2026-10-02",
"done_on": "2026-10-04",
"overdue": false,
"from_date": "2026-09-29"
}
}
}My private 1:1 note#
POST/v1/org/one_on_ones.noteWrite
Saves your own private note for a 1:1 meeting (empty text deletes it; 5000 characters) and, after it, your own rating of it (useful, ok, not_really). Only you ever see them in Bizisy: not the other person, not higher managers, not HR; Activity records that a note was saved, never its text. The two people only; over an API key or AI app, the person's own only.
- Who can call it
- Manage key any Manage role
Me key anyone - Keys and apps
- Only your own private note in your own 1:1.
- MCP tool
org_one_on_ones_noteon My Workplace, HR Assistant- 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
meeting_idstringrequiredtextstringUp to 5000 characters.
rating"useful" | "ok" | "not_really"
Returns
textstringrequiredrating"useful" | "ok" | "not_really"required
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.note \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"meeting_id":"m-p2-p1","text":"Ask about the move"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.note', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"meeting_id": "m-p2-p1",
"text": "Ask about the move"
}),
});
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/org/one_on_ones.note",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"meeting_id": "m-p2-p1",
"text": "Ask about the move",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"text": "Ask about the move",
"rating": null
}
}A 1:1 for my calendar#
POST/v1/org/one_on_ones.icsRead
A recurring calendar event (.ics) for a 1:1, to add to your own calendar: its title names the two people, never the agenda. The two people in it.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_icson My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
series_idstringThe 1:1 series (from
org_one_on_ones_mine).person_idstringOr a person: their 1:1 with their manager today.
Returns
icsstringrequiredfilenamestringrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.ics \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"series_id":"org-acme:p2:p1"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.ics', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"series_id": "org-acme:p2:p1"
}),
});
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/org/one_on_ones.ics",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"series_id": "org-acme:p2:p1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"ics": "BEGIN:VCALENDAR\r\nEND:VCALENDAR\r\n",
"filename": "1-1.ics"
}
}1:1 agenda templates#
POST/v1/org/one_on_ones.templates_listRead
The company's 1:1 agenda templates: the four starters (Weekly 1:1, Monthly growth, First 1:1 with a new hire, Skip-level; HR can edit them) and its own, each with up to 10 prompts. Anyone in the company.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_templates_liston My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
itemsobject[]required4 fields
idstringrequirednamestringrequiredpromptsstring[]requiredstarterbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.templates_list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.templates_list', {
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/org/one_on_ones.templates_list",
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": "tpl_weekly",
"name": "Weekly 1:1",
"prompts": [
"What are your top 3 priorities this week?",
"Is anything blocking you?"
],
"starter": true
}
]
}
}Save a 1:1 agenda template#
POST/v1/org/one_on_ones.templates_saveWrite
Saves a 1:1 agenda template: id to change one (a starter's id keeps the starter's place), name and 1 to 10 prompts (500 characters); remove true deletes the company's own (a starter goes back to Bizisy's text). Up to 20. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
org_one_on_ones_templates_saveon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
idstringnamestring1–80 characters.
promptsstring[]1–500 characters. 1–10 items.
removetrue
Returns
itemsobject[]required4 fields
idstringrequirednamestringrequiredpromptsstring[]requiredstarterbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.templates_save \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"name":"Sales 1:1","prompts":["Pipeline this week?"]}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.templates_save', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"name": "Sales 1:1",
"prompts": [
"Pipeline this week?"
]
}),
});
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/org/one_on_ones.templates_save",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"name": "Sales 1:1",
"prompts": [
"Pipeline this week?",
],
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"id": "tpl_weekly",
"name": "Weekly 1:1",
"prompts": [
"What are your top 3 priorities this week?",
"Is anything blocking you?"
],
"starter": true
}
]
}
}1:1 settings#
POST/v1/org/one_on_ones.settings_getRead
How 1:1s work in the company: the usual rhythm and length, the default template, whether the first 1:1 of each month is a growth conversation, whether skip-levels are allowed, and whether calendar invites are sent. Anyone in the company.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_settings_geton My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
7 fields
cadence"weekly" | "biweekly" | "monthly"requiredlengthintegerrequiredtemplate_idstringrequiredmonthly_growthbooleanrequiredskip_levelsbooleanrequiredinvitesbooleanrequiredasked_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.settings_get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.settings_get', {
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/org/one_on_ones.settings_get",
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": {
"cadence": "weekly",
"length": 30,
"template_id": "tpl_weekly",
"monthly_growth": true,
"skip_levels": true,
"invites": false,
"asked_at": null
}
}Change 1:1 settings#
POST/v1/org/one_on_ones.settings_updateWrite
Changes how 1:1s work: cadence and length (the default when one is set up), template_id, monthly_growth, skip_levels and invites (recurring invites through the company's Google or Outlook calendar connection). Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
org_one_on_ones_settings_updateon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
cadence"weekly" | "biweekly" | "monthly"lengthintegertemplate_idstringmonthly_growthbooleanskip_levelsbooleaninvitesboolean
Returns
7 fields
cadence"weekly" | "biweekly" | "monthly"requiredlengthintegerrequiredtemplate_idstringrequiredmonthly_growthbooleanrequiredskip_levelsbooleanrequiredinvitesbooleanrequiredasked_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.settings_update \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"cadence": "biweekly",
"length": 45,
"template_id": "tpl_weekly",
"monthly_growth": false,
"invites": true
}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.settings_update', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"cadence": "biweekly",
"length": 45,
"template_id": "tpl_weekly",
"monthly_growth": false,
"invites": 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/org/one_on_ones.settings_update",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"cadence": "biweekly",
"length": 45,
"template_id": "tpl_weekly",
"monthly_growth": False,
"invites": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"cadence": "biweekly",
"length": 45,
"template_id": "tpl_weekly",
"monthly_growth": false,
"skip_levels": true,
"invites": true,
"asked_at": null
}
}1:1 health#
POST/v1/org/one_on_ones.healthRead
For owners, admins and HR: whether 1:1s happen, never what is said in them. Per person working here with a manager: their regular 1:1 with their manager (rhythm), the last held, meetings held vs planned in the last 90 days, open and overdue action items, exempt; totals and per team; people with none held in 45 days. format csv for a file. In the app only.
- Web app only
- Refused for API keys and connected apps. HR reads 1:1 health in the Bizisy app.
- MCP tool
org_one_on_ones_healthon HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
unit_idstringformat"json" | "csv"
Returns
todaystringrequiredtotalsobjectrequired7 fields
peopleintegerrequiredwith_seriesintegerrequiredexemptintegerrequiredheld_ratenumber | nullrequiredgapintegerrequiredactions_on_timenumber | nullrequiredoverdue_actionsintegerrequired
teamsobject[]required6 fields
idstring | nullrequirednamestringrequiredpeopleintegerrequiredwith_seriesintegerrequiredmedian_daysnumber | nullrequiredoverdue_actionsintegerrequired
rowsobject[]required8 fields
personobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
managerobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
teamstring | nullrequiredcadence"weekly" | "biweekly" | "monthly"requiredlast_heldstring | nullrequiredexemptbooleanrequiredoverdue_actionsintegerrequiredgapbooleanrequired
csvstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.health \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"unit_id":"u1","format":"csv"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.health', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"unit_id": "u1",
"format": "csv"
}),
});
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/org/one_on_ones.health",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"unit_id": "u1",
"format": "csv",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"today": "2026-10-04",
"totals": {
"people": 3,
"with_series": 2,
"exempt": 0,
"held_rate": 0.86,
"gap": 1,
"actions_on_time": 0.68,
"overdue_actions": 1
},
"teams": [
{
"id": "u1",
"name": "Product",
"people": 3,
"with_series": 2,
"median_days": 5,
"overdue_actions": 1
}
],
"rows": [
{
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"manager": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"team": "Product",
"cadence": "weekly",
"last_held": "2026-09-29",
"exempt": false,
"overdue_actions": 1,
"gap": false
}
],
"csv": null
}
}Ask or remind managers about 1:1s#
POST/v1/org/one_on_ones.nudge_managersWrite
For owners, admins and HR: ask (all managers with a report who has no regular 1:1; once every 30 days) or remind (the managers of the people given, who have had no 1:1 held in 45 days; each manager at most once every 14 days) by notice and email. Exempt people are left out. Returns how many managers were told. In the app only.
- Web app only
- Refused for API keys and connected apps. HR asks or reminds managers from the Bizisy app.
- MCP tool
org_one_on_ones_nudge_managerson HR Assistant- 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
mode"ask" | "remind"requiredperson_idsstring[]Up to 500 items.
Returns
managersintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.nudge_managers \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"mode":"remind","person_ids":["p3"]}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.nudge_managers', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"mode": "remind",
"person_ids": [
"p3"
]
}),
});
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/org/one_on_ones.nudge_managers",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"mode": "remind",
"person_ids": [
"p3",
],
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"managers": 2
}
}1:1 exemptions#
POST/v1/org/one_on_ones.exemptions_listRead
Exemptions from 1:1s as you may see them: your own; as a manager, your direct reports'; owners, admins and HR all. waiting_for_me marks those for your decision (a manager decides a person's own request first, HR every request). Justifications are private: the person, their direct manager and HR only.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
org_one_on_ones_exemptions_liston My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
waiting_for_meboolean
Returns
itemsobject[]required11 fields
idstringrequiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_byobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_as"manager" | "person" | "hr"requiredjustificationstring | nullrequiredOnly the person, their direct manager and HR.
untilstring | nullrequiredstatus"pending_manager" | "pending_hr" | "approved" | "declined" | "withdrawn" | "ended"requiredmanager_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
hr_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
waiting_for_mebooleanrequiredcreated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.exemptions_list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"waiting_for_me":true}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.exemptions_list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"waiting_for_me": true
}),
});
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/org/one_on_ones.exemptions_list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"waiting_for_me": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"id": "x1",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"requested_by": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"requested_as": "manager",
"justification": "Works shifts with a team lead daily.",
"until": null,
"status": "pending_hr",
"manager_decision": {
"approve": true,
"at": "2026-10-04T10:00:00.000Z",
"note": null
},
"hr_decision": null,
"waiting_for_me": true,
"created_at": "2026-10-04T10:00:00.000Z"
}
]
}
}Ask for a 1:1 exemption#
POST/v1/org/one_on_ones.exemption_requestWrite
Asks for a person to be exempt from regular 1:1s, with a justification (1000 characters; private to the person, their direct manager and HR) and an optional end date. Their direct manager asks: HR decides. The person asks for themself: their manager decides, then HR. Owners, admins and HR record one directly (approved at once). One pending request per person. In the app only.
- Web app only
- Refused for API keys and connected apps. Exemptions carry a justification: asked for in the Bizisy app.
- MCP tool
org_one_on_ones_exemption_requeston My Workplace, HR Assistant- 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
person_idstringrequiredjustificationstringrequired10–1000 characters.
untilstring | null
Returns
11 fields
idstringrequiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_byobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_as"manager" | "person" | "hr"requiredjustificationstring | nullrequiredOnly the person, their direct manager and HR.
untilstring | nullrequiredstatus"pending_manager" | "pending_hr" | "approved" | "declined" | "withdrawn" | "ended"requiredmanager_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
hr_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
waiting_for_mebooleanrequiredcreated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.exemption_request \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"person_id": "p3",
"justification": "Part-time this quarter.",
"until": "2026-12-31"
}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.exemption_request', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"person_id": "p3",
"justification": "Part-time this quarter.",
"until": "2026-12-31"
}),
});
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/org/one_on_ones.exemption_request",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"person_id": "p3",
"justification": "Part-time this quarter.",
"until": "2026-12-31",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "x1",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"requested_by": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"requested_as": "manager",
"justification": "Part-time this quarter.",
"until": "2026-12-31",
"status": "pending_hr",
"manager_decision": {
"approve": true,
"at": "2026-10-04T10:00:00.000Z",
"note": null
},
"hr_decision": null,
"waiting_for_me": true,
"created_at": "2026-10-04T10:00:00.000Z"
}
}Decide a 1:1 exemption#
POST/v1/org/one_on_ones.exemption_decideWrite
Approves or declines an exemption request waiting for you: as the person's direct manager (their own request; approving sends it to HR) or as owners, admins and HR (the final decision). An optional note goes to the person. Approval ends their regular 1:1 (history kept). In the app only.
- Web app only
- Refused for API keys and connected apps. Exemptions are decided in the Bizisy app.
- MCP tool
org_one_on_ones_exemption_decideon My Workplace, HR Assistant- 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
exemption_idstringrequiredapprovebooleanrequirednotestringUp to 500 characters.
Returns
11 fields
idstringrequiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_byobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_as"manager" | "person" | "hr"requiredjustificationstring | nullrequiredOnly the person, their direct manager and HR.
untilstring | nullrequiredstatus"pending_manager" | "pending_hr" | "approved" | "declined" | "withdrawn" | "ended"requiredmanager_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
hr_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
waiting_for_mebooleanrequiredcreated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.exemption_decide \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"exemption_id":"x1","approve":false,"note":"Let’s try monthly."}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.exemption_decide', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"exemption_id": "x1",
"approve": false,
"note": "Let’s try monthly."
}),
});
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/org/one_on_ones.exemption_decide",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"exemption_id": "x1",
"approve": False,
"note": "Let’s try monthly.",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "x1",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"requested_by": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"requested_as": "manager",
"justification": "Works shifts with a team lead daily.",
"until": null,
"status": "approved",
"manager_decision": {
"approve": true,
"at": "2026-10-04T10:00:00.000Z",
"note": null
},
"hr_decision": {
"approve": true,
"at": "2026-10-04T11:00:00.000Z",
"note": null
},
"waiting_for_me": false,
"created_at": "2026-10-04T10:00:00.000Z"
}
}Withdraw or end a 1:1 exemption#
POST/v1/org/one_on_ones.exemption_closeWrite
Withdraws a pending exemption request (whoever asked, or HR) or ends an approved exemption (owners, admins and HR only; the person is told): regular 1:1s are expected again. In the app only.
- Web app only
- Refused for API keys and connected apps. Withdrawn or ended in the Bizisy app.
- MCP tool
org_one_on_ones_exemption_closeon My Workplace, HR Assistant- 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
exemption_idstringrequired
Returns
11 fields
idstringrequiredpersonobjectrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_byobject | nullrequired4 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredphoto_urlstring | nullrequired
requested_as"manager" | "person" | "hr"requiredjustificationstring | nullrequiredOnly the person, their direct manager and HR.
untilstring | nullrequiredstatus"pending_manager" | "pending_hr" | "approved" | "declined" | "withdrawn" | "ended"requiredmanager_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
hr_decisionobject | nullrequired3 fields
approvebooleanrequiredatstringrequirednotestring | nullrequired
waiting_for_mebooleanrequiredcreated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/org/one_on_ones.exemption_close \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"exemption_id":"x1"}'const res = await fetch('https://api.bizisy.com/v1/org/one_on_ones.exemption_close', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"exemption_id": "x1"
}),
});
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/org/one_on_ones.exemption_close",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"exemption_id": "x1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "x1",
"person": {
"id": "p3",
"name": "Sofia Costa",
"title": "Product Designer",
"photo_url": null
},
"requested_by": {
"id": "p2",
"name": "Tomás Silva",
"title": "Head of Product",
"photo_url": null
},
"requested_as": "manager",
"justification": "Works shifts with a team lead daily.",
"until": null,
"status": "withdrawn",
"manager_decision": {
"approve": true,
"at": "2026-10-04T10:00:00.000Z",
"note": null
},
"hr_decision": null,
"waiting_for_me": false,
"created_at": "2026-10-04T10:00:00.000Z"
}
}Something missing or wrong on this page? Write to hello@bizisy.com.