API reference
Activity
The record of every change, with who made it and through what.
5 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
List activity#
POST/v1/platform/activity.listRead
Lists Activity entries, newest first: every change made in Bizisy (and, for AI assistants, every preview and failed attempt), with who did it, through what (web or which API key), status (ok, dry_run = preview only, error), a one-line summary and links to what it touched. Owners, admins and HR (in Manage) see the whole organization; everyone else, and every call through the me audience, sees only their own activity. Filter by status, channel (ui, api, mcp, job), action_id, actor_user_id, or subject_id: entries about one record, e.g. a person id from org_people_list (changes to their profile, job, pay, invites and login link). Each entry lists subject_ids (ids only, never names). Page with before = next_before from the previous page; limit defaults to 50 (at most 100).
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
platform_activity_liston My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
status"ok" | "dry_run" | "error"actor_user_idstringaction_idstringchannel"ui" | "api" | "mcp" | "job"subject_idstringA record id (e.g. a person id): only entries about it.
beforestring | nullAn entry id: return only entries older than it (next_before of the previous page).
limitintegerFrom 1 to 100. Default
50.
Returns
entriesobject[]required18 fields
idstringrequiredcreated_atstringrequiredaction_idstringrequiredaction_titlestringrequiredkind"read" | "write" | "destructive"requiredchannel"ui" | "api" | "mcp" | "job"requiredstatus"ok" | "dry_run" | "error"requireddry_runbooleanrequiredsummarystringrequiredactorobject | nullrequired7 fields
user_idstringrequiredperson_idstring | nullrequirednamestring | nullrequiredemailstring | nullrequiredcredentialobjectrequired4 fields
kind"session" | "api_key"requiredidstringrequirednamestring | nullrequiredappbooleanrequiredA connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.
via_firmstring | nullDone by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".
via_assistantbooleanA request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".
inputobject | nullrequiredinput_keysstring[] | nullrequirederrorobject | nullrequired2 fields
codestringrequiredmessagestringrequired
linksobject[]required2 fields
labelstringrequiredpathstringrequired
subject_idsstring[]requiredeventsstring[]requiredhas_changesbooleanrequiredchanges_recordedbooleanrequired
next_beforestring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/activity.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"actor_user_id": "u1",
"action_id": "org.people.hire",
"before": "01k0000000000000000000000a"
}'const res = await fetch('https://api.bizisy.com/v1/platform/activity.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"actor_user_id": "u1",
"action_id": "org.people.hire",
"before": "01k0000000000000000000000a"
}),
});
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/platform/activity.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"actor_user_id": "u1",
"action_id": "org.people.hire",
"before": "01k0000000000000000000000a",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"entries": [
{
"id": "01k0000000000000000000000a",
"created_at": "2026-10-04T10:00:00.000Z",
"action_id": "org.people.change_job",
"action_title": "Change a person's job (effective-dated)",
"kind": "write",
"channel": "mcp",
"status": "dry_run",
"dry_run": true,
"summary": "Changed a person's job (from 2026-11-01)",
"actor": {
"user_id": "usr1",
"person_id": "p1",
"name": "Ana Ferreira",
"email": "ana@acme.test",
"credential": {
"kind": "api_key",
"id": "k1",
"name": "Claude",
"app": false
}
},
"input": {
"person_id": "p1",
"title": "Lead"
},
"input_keys": null,
"error": null,
"links": [
{
"label": "Open person",
"path": "/manage/people/p1"
}
],
"subject_ids": [
"p1"
],
"events": [
"org.person.job_changed.v1"
],
"has_changes": false,
"changes_recorded": true
}
],
"next_before": null
}
}Get an activity entry#
POST/v1/platform/activity.getRead
Returns one Activity entry by id (the id at the end of a view_url). Owners, admins and HR (in Manage) see the whole organization; everyone else, and every call through the me audience, sees only their own activity. not_found otherwise.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
platform_activity_geton My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
idstringrequired
Returns
18 fields
idstringrequiredcreated_atstringrequiredaction_idstringrequiredaction_titlestringrequiredkind"read" | "write" | "destructive"requiredchannel"ui" | "api" | "mcp" | "job"requiredstatus"ok" | "dry_run" | "error"requireddry_runbooleanrequiredsummarystringrequiredactorobject | nullrequired7 fields
user_idstringrequiredperson_idstring | nullrequirednamestring | nullrequiredemailstring | nullrequiredcredentialobjectrequired4 fields
kind"session" | "api_key"requiredidstringrequirednamestring | nullrequiredappbooleanrequiredA connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.
via_firmstring | nullDone by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".
via_assistantbooleanA request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".
inputobject | nullrequiredinput_keysstring[] | nullrequirederrorobject | nullrequired2 fields
codestringrequiredmessagestringrequired
linksobject[]required2 fields
labelstringrequiredpathstringrequired
subject_idsstring[]requiredeventsstring[]requiredhas_changesbooleanrequiredchanges_recordedbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/activity.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id":"01k0000000000000000000000a"}'const res = await fetch('https://api.bizisy.com/v1/platform/activity.get', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"id": "01k0000000000000000000000a"
}),
});
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/platform/activity.get",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"id": "01k0000000000000000000000a",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "01k0000000000000000000000a",
"created_at": "2026-10-04T10:00:00.000Z",
"action_id": "org.people.change_job",
"action_title": "Change a person's job (effective-dated)",
"kind": "write",
"channel": "mcp",
"status": "dry_run",
"dry_run": true,
"summary": "Changed a person's job (from 2026-11-01)",
"actor": {
"user_id": "usr1",
"person_id": "p1",
"name": "Ana Ferreira",
"email": "ana@acme.test",
"credential": {
"kind": "api_key",
"id": "k1",
"name": "Claude",
"app": false
}
},
"input": {
"person_id": "p1",
"title": "Lead"
},
"input_keys": null,
"error": null,
"links": [
{
"label": "Open person",
"path": "/manage/people/p1"
}
],
"subject_ids": [
"p1"
],
"events": [
"org.person.job_changed.v1"
],
"has_changes": false,
"changes_recorded": true
}
}What changed in an activity entry#
POST/v1/platform/activity.changesRead
What one Activity entry changed, record by record: for each record (a profile, a job period, pay, a team, a document…) the fields before and after. You see the values you may see of each person (the same rules as reading them: pay and private details only for the person and for owners, admins and HR in the app; API keys and AI assistants never get other people's private or pay values); other fields are listed as changed with hidden: true. Entries recorded before the change journal have changes_recorded false. Bulk entries (an import) page with after_seq = next_seq. Who may open the entry: as platform_activity_get.
- Who can call it
- Manage key any Manage role
Me key anyone - Keys and apps
- Other people's pay and private values come back hidden (hidden: true, no values).
- MCP tool
platform_activity_changeson My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
entry_idstringrequiredAn Activity entry id (
platform_activity_list).after_seqintegernext_seq of the previous page.
At least 0.
limitintegerFrom 1 to 200. Default
100.
Returns
entryobjectrequired18 fields
idstringrequiredcreated_atstringrequiredaction_idstringrequiredaction_titlestringrequiredkind"read" | "write" | "destructive"requiredchannel"ui" | "api" | "mcp" | "job"requiredstatus"ok" | "dry_run" | "error"requireddry_runbooleanrequiredsummarystringrequiredactorobject | nullrequired7 fields
user_idstringrequiredperson_idstring | nullrequirednamestring | nullrequiredemailstring | nullrequiredcredentialobjectrequired4 fields
kind"session" | "api_key"requiredidstringrequirednamestring | nullrequiredappbooleanrequiredA connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.
via_firmstring | nullDone by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".
via_assistantbooleanA request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".
inputobject | nullrequiredinput_keysstring[] | nullrequirederrorobject | nullrequired2 fields
codestringrequiredmessagestringrequired
linksobject[]required2 fields
labelstringrequiredpathstringrequired
subject_idsstring[]requiredeventsstring[]requiredhas_changesbooleanrequiredchanges_recordedbooleanrequired
changesobject[]required8 fields
idstringrequiredentry_idstringrequiredatstringrequiredop"insert" | "update" | "delete"requiredrecordobjectrequired4 fields
kindstringrequiredidstringrequirednamestring | nullrequireddatestring | nullrequired
person_idsstring[]requiredfieldsobject[]required6 fields
keystringrequiredlabelstring | nullrequiredtier"public" | "job" | "private" | "pay" | "hr"requiredbeforeobjectrequired27 fields (one of several shapes)
Option 1
t"text"requiredvstringrequired
Option 2
t"number"requiredvnumberrequired
Option 3
t"bool"requiredvbooleanrequired
Option 4
t"date"requiredvstringrequired
Option 5
t"datetime"requiredvstringrequired
Option 6
t"money"requiredamountnumberrequiredcurrencystringrequiredperiodstring | nullrequired
Option 7
t"ref"requiredkindstring (enum)requiredOne of:
person,unit,location,title,entity,position,family,level,category,field,document,checklist.idstringrequirednamestring | nullrequired
Option 8
t"enum"requiredsetstringrequiredvstringrequired
Option 9
t"list"requireditemsany[]required
Option 10
t"file"requirednamestring | nullrequiredsizenumber | nullrequired
Option 11
t"secret"required
afterobjectrequired27 fields (one of several shapes)
Option 1
t"text"requiredvstringrequired
Option 2
t"number"requiredvnumberrequired
Option 3
t"bool"requiredvbooleanrequired
Option 4
t"date"requiredvstringrequired
Option 5
t"datetime"requiredvstringrequired
Option 6
t"money"requiredamountnumberrequiredcurrencystringrequiredperiodstring | nullrequired
Option 7
t"ref"requiredkindstring (enum)requiredOne of:
person,unit,location,title,entity,position,family,level,category,field,document,checklist.idstringrequirednamestring | nullrequired
Option 8
t"enum"requiredsetstringrequiredvstringrequired
Option 9
t"list"requireditemsany[]required
Option 10
t"file"requirednamestring | nullrequiredsizenumber | nullrequired
Option 11
t"secret"required
hiddenbooleanrequired
truncatedbooleanrequired
next_seqinteger | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/activity.changes \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"entry_id":"01k0000000000000000000000b","after_seq":99,"limit":200}'const res = await fetch('https://api.bizisy.com/v1/platform/activity.changes', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"entry_id": "01k0000000000000000000000b",
"after_seq": 99,
"limit": 200
}),
});
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/platform/activity.changes",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"entry_id": "01k0000000000000000000000b",
"after_seq": 99,
"limit": 200,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"entry": {
"id": "01k0000000000000000000000b",
"created_at": "2026-10-04T10:00:00.000Z",
"action_id": "org.people.change_job",
"action_title": "Change a person's job (effective-dated)",
"kind": "write",
"channel": "ui",
"status": "ok",
"dry_run": false,
"summary": "Changed a person's job (from 2026-11-01)",
"actor": {
"user_id": "usr1",
"person_id": "p1",
"name": "Ana Ferreira",
"email": "ana@acme.test",
"credential": {
"kind": "api_key",
"id": "k1",
"name": "Claude",
"app": false
}
},
"input": {
"person_id": "p1",
"title": "Lead"
},
"input_keys": null,
"error": null,
"links": [
{
"label": "Open person",
"path": "/manage/people/p1"
}
],
"subject_ids": [
"p1"
],
"events": [
"org.person.job_changed.v1"
],
"has_changes": true,
"changes_recorded": true
},
"changes": [
{
"id": "01k0000000000000000000000c",
"entry_id": "01k0000000000000000000000b",
"at": "2026-10-04T10:00:00.000Z",
"op": "update",
"record": {
"kind": "job",
"id": "j1",
"name": null,
"date": "2026-11-01"
},
"person_ids": [
"p1"
],
"truncated": false,
"fields": [
{
"key": "title",
"label": null,
"tier": "job",
"before": {
"t": "text",
"v": "Engineer"
},
"after": {
"t": "text",
"v": "Senior Engineer"
},
"hidden": false
},
{
"key": "manager_id",
"label": null,
"tier": "job",
"before": {
"t": "ref",
"kind": "person",
"id": "p2",
"name": "Rui Costa"
},
"after": {
"t": "ref",
"kind": "person",
"id": "p3",
"name": null
},
"hidden": false
},
{
"key": "iban",
"label": null,
"tier": "private",
"before": null,
"after": null,
"hidden": true
}
]
},
{
"id": "01k0000000000000000000000d",
"entry_id": "01k0000000000000000000000b",
"at": "2026-10-04T10:00:00.000Z",
"op": "insert",
"record": {
"kind": "pay",
"id": "pay1",
"name": null,
"date": "2026-11-01"
},
"person_ids": [
"p1"
],
"truncated": false,
"fields": [
{
"key": "amount",
"label": null,
"tier": "pay",
"before": null,
"after": {
"t": "money",
"amount": 52000,
"currency": "EUR",
"period": "year"
},
"hidden": false
},
{
"key": "period",
"label": null,
"tier": "pay",
"before": null,
"after": {
"t": "enum",
"set": "pay_period",
"v": "year"
},
"hidden": false
}
]
}
],
"next_seq": null
}
}A person's change history#
POST/v1/platform/activity.about_personRead
The change history of one person (a person id from org_people_list), newest first: every recorded change to their profile, job, pay and other records, with what changed (before and after) and the Activity entry that made it. Values follow the same rules as reading the person (pay and private details only for owners, admins and HR in the app; over an API key or AI assistant those fields show as changed with hidden: true). Owners, admins and HR. Page with before = next_before.
- Who can call it
- Manage key owner admin hr
- Keys and apps
- Pay and private values come back hidden (hidden: true, no values).
- MCP tool
platform_activity_about_personon HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
person_idstringrequiredbeforestring | nullnext_before of the previous page.
limitintegerFrom 1 to 50. Default
20.
Returns
itemsobject[]required2 fields
entryobject | nullrequired18 fields
idstringrequiredcreated_atstringrequiredaction_idstringrequiredaction_titlestringrequiredkind"read" | "write" | "destructive"requiredchannel"ui" | "api" | "mcp" | "job"requiredstatus"ok" | "dry_run" | "error"requireddry_runbooleanrequiredsummarystringrequiredactorobject | nullrequired7 fields
user_idstringrequiredperson_idstring | nullrequirednamestring | nullrequiredemailstring | nullrequiredcredentialobjectrequired4 fields
kind"session" | "api_key"requiredidstringrequirednamestring | nullrequiredappbooleanrequiredA connected app (signed in with OAuth) or an installed marketplace app rather than an API key; name is the app's.
via_firmstring | nullDone by a person of one of the company's partner firms through its partner access: shown as "<name> (via <firm>)".
via_assistantbooleanA request the person confirmed in Ask HR, the in-app assistant: shown as "<name> (via Ask HR)".
inputobject | nullrequiredinput_keysstring[] | nullrequirederrorobject | nullrequired2 fields
codestringrequiredmessagestringrequired
linksobject[]required2 fields
labelstringrequiredpathstringrequired
subject_idsstring[]requiredeventsstring[]requiredhas_changesbooleanrequiredchanges_recordedbooleanrequired
changesobject[]required8 fields
idstringrequiredentry_idstringrequiredatstringrequiredop"insert" | "update" | "delete"requiredrecordobjectrequired4 fields
kindstringrequiredidstringrequirednamestring | nullrequireddatestring | nullrequired
person_idsstring[]requiredfieldsobject[]required6 fields
keystringrequiredlabelstring | nullrequiredtier"public" | "job" | "private" | "pay" | "hr"requiredbeforeobjectrequired27 fields (one of several shapes)
Option 1
t"text"requiredvstringrequired
Option 2
t"number"requiredvnumberrequired
Option 3
t"bool"requiredvbooleanrequired
Option 4
t"date"requiredvstringrequired
Option 5
t"datetime"requiredvstringrequired
Option 6
t"money"requiredamountnumberrequiredcurrencystringrequiredperiodstring | nullrequired
Option 7
t"ref"requiredkindstring (enum)requiredOne of:
person,unit,location,title,entity,position,family,level,category,field,document,checklist.idstringrequirednamestring | nullrequired
Option 8
t"enum"requiredsetstringrequiredvstringrequired
Option 9
t"list"requireditemsany[]required
Option 10
t"file"requirednamestring | nullrequiredsizenumber | nullrequired
Option 11
t"secret"required
afterobjectrequired27 fields (one of several shapes)
Option 1
t"text"requiredvstringrequired
Option 2
t"number"requiredvnumberrequired
Option 3
t"bool"requiredvbooleanrequired
Option 4
t"date"requiredvstringrequired
Option 5
t"datetime"requiredvstringrequired
Option 6
t"money"requiredamountnumberrequiredcurrencystringrequiredperiodstring | nullrequired
Option 7
t"ref"requiredkindstring (enum)requiredOne of:
person,unit,location,title,entity,position,family,level,category,field,document,checklist.idstringrequirednamestring | nullrequired
Option 8
t"enum"requiredsetstringrequiredvstringrequired
Option 9
t"list"requireditemsany[]required
Option 10
t"file"requirednamestring | nullrequiredsizenumber | nullrequired
Option 11
t"secret"required
hiddenbooleanrequired
truncatedbooleanrequired
next_beforestring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/activity.about_person \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_id":"p1","before":"01k0000000000000000000000c","limit":50}'const res = await fetch('https://api.bizisy.com/v1/platform/activity.about_person', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"person_id": "p1",
"before": "01k0000000000000000000000c",
"limit": 50
}),
});
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/platform/activity.about_person",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"person_id": "p1",
"before": "01k0000000000000000000000c",
"limit": 50,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"entry": {
"id": "01k0000000000000000000000b",
"created_at": "2026-10-04T10:00:00.000Z",
"action_id": "org.people.change_job",
"action_title": "Change a person's job (effective-dated)",
"kind": "write",
"channel": "ui",
"status": "ok",
"dry_run": false,
"summary": "Changed a person's job (from 2026-11-01)",
"actor": {
"user_id": "usr1",
"person_id": "p1",
"name": "Ana Ferreira",
"email": "ana@acme.test",
"credential": {
"kind": "api_key",
"id": "k1",
"name": "Claude",
"app": false
}
},
"input": {
"person_id": "p1",
"title": "Lead"
},
"input_keys": null,
"error": null,
"links": [
{
"label": "Open person",
"path": "/manage/people/p1"
}
],
"subject_ids": [
"p1"
],
"events": [
"org.person.job_changed.v1"
],
"has_changes": true,
"changes_recorded": true
},
"changes": [
{
"id": "01k0000000000000000000000c",
"entry_id": "01k0000000000000000000000b",
"at": "2026-10-04T10:00:00.000Z",
"op": "update",
"record": {
"kind": "job",
"id": "j1",
"name": null,
"date": "2026-11-01"
},
"person_ids": [
"p1"
],
"truncated": false,
"fields": [
{
"key": "title",
"label": null,
"tier": "job",
"before": {
"t": "text",
"v": "Engineer"
},
"after": {
"t": "text",
"v": "Senior Engineer"
},
"hidden": false
},
{
"key": "manager_id",
"label": null,
"tier": "job",
"before": {
"t": "ref",
"kind": "person",
"id": "p2",
"name": "Rui Costa"
},
"after": {
"t": "ref",
"kind": "person",
"id": "p3",
"name": null
},
"hidden": false
},
{
"key": "iban",
"label": null,
"tier": "private",
"before": null,
"after": null,
"hidden": true
}
]
},
{
"id": "01k0000000000000000000000d",
"entry_id": "01k0000000000000000000000b",
"at": "2026-10-04T10:00:00.000Z",
"op": "insert",
"record": {
"kind": "pay",
"id": "pay1",
"name": null,
"date": "2026-11-01"
},
"person_ids": [
"p1"
],
"truncated": false,
"fields": [
{
"key": "amount",
"label": null,
"tier": "pay",
"before": null,
"after": {
"t": "money",
"amount": 52000,
"currency": "EUR",
"period": "year"
},
"hidden": false
},
{
"key": "period",
"label": null,
"tier": "pay",
"before": null,
"after": {
"t": "enum",
"set": "pay_period",
"v": "year"
},
"hidden": false
}
]
}
]
},
{
"entry": null,
"changes": [
{
"id": "x2",
"entry_id": "gone",
"at": "2026-10-04T10:00:00.000Z",
"op": "delete",
"record": {
"kind": "job",
"id": "j1",
"name": null,
"date": "2026-11-01"
},
"person_ids": [
"p1"
],
"truncated": false,
"fields": []
}
]
}
],
"next_before": null
}
}My change history#
POST/v1/platform/activity.about_meRead
Changes made to your own records (your profile, job and pay, and your requests about pay levels), newest first: what changed (before and after), when and by whom (you, a colleague, an app or an automatic job). Only what you can see about yourself in Bizisy; records HR keeps to itself are never listed. Page with before = next_before.
- Who can call it
- Me key anyone
- MCP tool
platform_activity_about_meon My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
beforestring | nullnext_before of the previous page.
limitintegerFrom 1 to 50. Default
20.
Returns
itemsobject[]required4 fields
entry_idstringrequiredatstringrequiredbyobjectrequired3 fields
kind"you" | "person" | "app" | "automatic"requirednamestring | nullrequiredperson_idstring | nullrequired
changesobject[]required8 fields
idstringrequiredentry_idstringrequiredatstringrequiredop"insert" | "update" | "delete"requiredrecordobjectrequired4 fields
kindstringrequiredidstringrequirednamestring | nullrequireddatestring | nullrequired
person_idsstring[]requiredfieldsobject[]required6 fields
keystringrequiredlabelstring | nullrequiredtier"public" | "job" | "private" | "pay" | "hr"requiredbeforeobjectrequired27 fields (one of several shapes)
Option 1
t"text"requiredvstringrequired
Option 2
t"number"requiredvnumberrequired
Option 3
t"bool"requiredvbooleanrequired
Option 4
t"date"requiredvstringrequired
Option 5
t"datetime"requiredvstringrequired
Option 6
t"money"requiredamountnumberrequiredcurrencystringrequiredperiodstring | nullrequired
Option 7
t"ref"requiredkindstring (enum)requiredOne of:
person,unit,location,title,entity,position,family,level,category,field,document,checklist.idstringrequirednamestring | nullrequired
Option 8
t"enum"requiredsetstringrequiredvstringrequired
Option 9
t"list"requireditemsany[]required
Option 10
t"file"requirednamestring | nullrequiredsizenumber | nullrequired
Option 11
t"secret"required
afterobjectrequired27 fields (one of several shapes)
Option 1
t"text"requiredvstringrequired
Option 2
t"number"requiredvnumberrequired
Option 3
t"bool"requiredvbooleanrequired
Option 4
t"date"requiredvstringrequired
Option 5
t"datetime"requiredvstringrequired
Option 6
t"money"requiredamountnumberrequiredcurrencystringrequiredperiodstring | nullrequired
Option 7
t"ref"requiredkindstring (enum)requiredOne of:
person,unit,location,title,entity,position,family,level,category,field,document,checklist.idstringrequirednamestring | nullrequired
Option 8
t"enum"requiredsetstringrequiredvstringrequired
Option 9
t"list"requireditemsany[]required
Option 10
t"file"requirednamestring | nullrequiredsizenumber | nullrequired
Option 11
t"secret"required
hiddenbooleanrequired
truncatedbooleanrequired
next_beforestring | nullrequiredlinkedbooleanrequiredFalse when your login is not linked to a person: there is no history to show.
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/activity.about_me \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"before":"01k0000000000000000000000c","limit":20}'const res = await fetch('https://api.bizisy.com/v1/platform/activity.about_me', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"before": "01k0000000000000000000000c",
"limit": 20
}),
});
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/platform/activity.about_me",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"before": "01k0000000000000000000000c",
"limit": 20,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"entry_id": "01k0000000000000000000000b",
"at": "2026-10-04T10:00:00.000Z",
"by": {
"kind": "person",
"name": "Ana Ferreira",
"person_id": "p1"
},
"changes": [
{
"id": "01k0000000000000000000000c",
"entry_id": "01k0000000000000000000000b",
"at": "2026-10-04T10:00:00.000Z",
"op": "update",
"record": {
"kind": "job",
"id": "j1",
"name": null,
"date": "2026-11-01"
},
"person_ids": [
"p1"
],
"truncated": false,
"fields": [
{
"key": "title",
"label": null,
"tier": "job",
"before": {
"t": "text",
"v": "Engineer"
},
"after": {
"t": "text",
"v": "Senior Engineer"
},
"hidden": false
},
{
"key": "manager_id",
"label": null,
"tier": "job",
"before": {
"t": "ref",
"kind": "person",
"id": "p2",
"name": "Rui Costa"
},
"after": {
"t": "ref",
"kind": "person",
"id": "p3",
"name": null
},
"hidden": false
},
{
"key": "iban",
"label": null,
"tier": "private",
"before": null,
"after": null,
"hidden": true
}
]
}
]
},
{
"entry_id": "e2",
"at": "2026-10-01T09:00:00.000Z",
"by": {
"kind": "you",
"name": null,
"person_id": null
},
"changes": []
}
],
"next_before": null,
"linked": true
}
}Something missing or wrong on this page? Write to hello@bizisy.com.