API reference
Talent insights
Talent insights (an AI system under the EU AI Act): the numbered setup and the switch, the worker notice, the DPIA template, the fairness check, problem reports, exclusions, explanation requests and the audit log. Bands, reviews and the people list are in the Bizisy app only (API keys and AI apps are refused).
21 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
Talent insights settings#
POST/v1/insights/settings.getRead
Talent insights: whether the company uses it, the numbered setup steps and the first one missing, which leave types count, who may see insights and who reviews them, the worker notice, DPIA and fairness check state, which factors have data and the provider. Owners, admins and HR. API keys and AI assistants get the setup state only (no leave types or coverage), never bands: those are only in the Bizisy app.
- Who can call it
- Manage key owner admin hr
- MCP tool
insights_settings_geton HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
22 fields
enabledbooleanrequiredenabled_atstring | nullrequiredattrition_onbooleanrequiredskills_onbooleanrequiredstepsobjectrequired6 fields
instructionsbooleanrequiredcountsbooleanrequiredaccessbooleanrequirednoticebooleanrequireddpiabooleanrequiredfairnessbooleanrequired
missing_step"instructions" | "counts" | "access" | "notice" | "dpia" | "fairness"requiredcounted_leave_typesstring[]requiredleave_typesobject[] | nullrequired7 fields
idstringrequirednamestring | nullrequiredbuiltinbooleanrequiredhealthbooleanrequiredcountablebooleanrequiredcountedbooleanrequiredlocked_reason"health" | "parental" | "away_only"required
manager_chainbooleanrequiredoversight_roles"owner" | "admin" | "hr"[]requirednoticeobjectrequired3 fields
announcement_idstring | nullrequiredsent_atstring | nullrequiredinformed_other_way_atstring | nullrequired
dpiaobjectrequired2 fields
confirmed_atstring | nullrequireddone_onstring | nullrequired
bias_checkobjectrequiredThe optional uploaded-groups fairness check.
3 fields
last_run_atstring | nullrequiredmode"synthetic_only" | "deployer"requiredresult_idstring | nullrequired
backtestobjectrequiredThe back-test on the company's own history (addendum B).
6 fields
last_run_atstring | nullrequiredresult_idstring | nullrequiredacknowledged_atstring | nullrequireddonebooleanrequiredStep 6: the latest back-test is acknowledged and at most 92 days old.
waitingbooleanrequiredThe latest back-test waits for an owner or admin to acknowledge it.
pausedbooleanrequiredUnacknowledged for over 30 days: new bands wait until it is acknowledged.
factorsobject[]required3 fields
idstringrequiredsourcestringrequiredavailablebooleanrequired
limited_databooleanrequiredcoverageobject | nullrequired3 fields
peopleintegerrequiredscoredintegerrequiredtimeclock_with_recordsinteger | nullrequired
providerobjectrequired5 fields
namestringrequirednipcstringrequiredcitystringrequiredcountrystringrequiredemailstringrequired
instructions_readbooleanrequiredStep 1, the deployer's confirmation (the step is done once an owner also accepted the addendum).
addendumobjectrequiredThe AI features addendum (step 1): the current version and whether it is accepted for Talent insights.
3 fields
versionstringrequiredacceptedbooleanrequiredaccepted_atstring | nullrequired
creditsobjectrequiredAI credits: 1 per person scored per calendar month; paused when none are left (bands kept).
4 fields
per_person_monthintegerrequiredpausedbooleanrequiredpaused_sincestring | nullrequiredleftinteger | nullrequired
modelstringrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/settings.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/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/insights/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,
"enabled_at": "2026-11-16T09:00:00.000Z",
"attrition_on": true,
"skills_on": true,
"steps": {
"instructions": true,
"counts": true,
"access": true,
"notice": true,
"dpia": true,
"fairness": true
},
"missing_step": null,
"counted_leave_types": [
"vacation",
"unpaid"
],
"leave_types": [
{
"id": "vacation",
"name": null,
"builtin": true,
"health": false,
"countable": true,
"counted": true,
"locked_reason": null
},
{
"id": "sick",
"name": null,
"builtin": true,
"health": true,
"countable": false,
"counted": false,
"locked_reason": "health"
},
{
"id": "lt1",
"name": "Moving day",
"builtin": false,
"health": false,
"countable": true,
"counted": false,
"locked_reason": null
}
],
"manager_chain": false,
"oversight_roles": [
"owner",
"admin",
"hr"
],
"notice": {
"announcement_id": "an1",
"sent_at": "2026-11-16T09:00:00.000Z",
"informed_other_way_at": null
},
"dpia": {
"confirmed_at": "2026-11-16T09:00:00.000Z",
"done_on": "2026-11-12"
},
"bias_check": {
"last_run_at": "2026-11-16T09:00:00.000Z",
"mode": "synthetic_only",
"result_id": null
},
"backtest": {
"last_run_at": "2026-11-16T09:00:00.000Z",
"result_id": "bt1",
"acknowledged_at": "2026-11-16T09:00:00.000Z",
"done": true,
"waiting": false,
"paused": false
},
"factors": [
{
"id": "F1",
"source": "org",
"available": true
},
{
"id": "F9",
"source": "talent",
"available": false
}
],
"limited_data": false,
"coverage": {
"people": 42,
"scored": 40,
"timeclock_with_records": null
},
"provider": {
"name": "Wisely Lda",
"nipc": "516845128",
"city": "Amares",
"country": "Portugal",
"email": "hello@bizisy.com"
},
"model": "attrition-v1",
"credits": {
"per_person_month": 1,
"paused": false,
"paused_since": null,
"left": 480
},
"instructions_read": true,
"addendum": {
"version": "ai-2",
"accepted": true,
"accepted_at": "2026-11-10T09:00:00.000Z"
}
}
}Change Talent insights settings#
POST/v1/insights/settings.updateWrite
Owners and admins, in the app only: records the setup steps (instructions read, leave types that count, manager-chain extension with a warning, oversight roles, informed another way, DPIA done, synthetic-only fairness check) and the switch. Switching on needs steps 1–6 (the refusal names the missing step); switching off deletes current bands at once and keeps the logs. Dry run shows how many people would be scored.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_settings_updateon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
accept_addendumobjectStep 1, on the same screen: accept the AI features addendum to the data processing agreement (
platform_ai_addendum_getshows its text), the version read. Owners only (as the data processing agreement); an admin asks an owner (platform_ai_addendum_request).2 fields
versionstringrequiredlang"en" | "de" | "es" | "fr" | "it" | "pt"Default
"en".
instructions_readtrueStep 1: the instructions for use were read and the company confirms its duties as deployer (AI Act Art. 26: use per the instructions, human oversight, inform workers, keep logs, report incidents; never decide on a band alone).
counted_leave_typesstring[]Step 2: leave type ids that count for "short-notice absences". Sick, parental, other and health types are never counted.
1–60 characters. Up to 40 items.
confirm_countstruemanager_chainbooleanStep 3: extend bands and job-tier factors to the person's manager chain (needs confirm_warning: true to switch on).
confirm_warningbooleanoversight_roles"owner" | "admin" | "hr"[]Step 3: the built-in roles that record reviews and answer explanation requests (Art. 26(2)).
1–3 items.
confirm_accesstrueinformed_other_way_onstringStep 4, instead of sending the announcement: the day people were informed another way.
Pattern
^\d{4}-\d{2}-\d{2}$.dpia_done_onstringStep 5: the day the DPIA was completed.
Pattern
^\d{4}-\d{2}-\d{2}$.fairness_synthetic_onlytrueNo longer completes step 6: the back-test on the company's own history (insights_checks_backtest_run, then acknowledge) replaced the synthetic-report option for every company size. Refused.
enabledbooleanStep 7: the switch. On needs steps 1–6; off hides bands at once, deletes current bands and stops the sweep (logs stay).
attrition_onbooleanskills_onboolean
Returns
23 fields
enabledbooleanrequiredenabled_atstring | nullrequiredattrition_onbooleanrequiredskills_onbooleanrequiredstepsobjectrequired6 fields
instructionsbooleanrequiredcountsbooleanrequiredaccessbooleanrequirednoticebooleanrequireddpiabooleanrequiredfairnessbooleanrequired
missing_step"instructions" | "counts" | "access" | "notice" | "dpia" | "fairness"requiredcounted_leave_typesstring[]requiredleave_typesobject[] | nullrequired7 fields
idstringrequirednamestring | nullrequiredbuiltinbooleanrequiredhealthbooleanrequiredcountablebooleanrequiredcountedbooleanrequiredlocked_reason"health" | "parental" | "away_only"required
manager_chainbooleanrequiredoversight_roles"owner" | "admin" | "hr"[]requirednoticeobjectrequired3 fields
announcement_idstring | nullrequiredsent_atstring | nullrequiredinformed_other_way_atstring | nullrequired
dpiaobjectrequired2 fields
confirmed_atstring | nullrequireddone_onstring | nullrequired
bias_checkobjectrequiredThe optional uploaded-groups fairness check.
3 fields
last_run_atstring | nullrequiredmode"synthetic_only" | "deployer"requiredresult_idstring | nullrequired
backtestobjectrequiredThe back-test on the company's own history (addendum B).
6 fields
last_run_atstring | nullrequiredresult_idstring | nullrequiredacknowledged_atstring | nullrequireddonebooleanrequiredStep 6: the latest back-test is acknowledged and at most 92 days old.
waitingbooleanrequiredThe latest back-test waits for an owner or admin to acknowledge it.
pausedbooleanrequiredUnacknowledged for over 30 days: new bands wait until it is acknowledged.
factorsobject[]required3 fields
idstringrequiredsourcestringrequiredavailablebooleanrequired
limited_databooleanrequiredcoverageobject | nullrequired3 fields
peopleintegerrequiredscoredintegerrequiredtimeclock_with_recordsinteger | nullrequired
providerobjectrequired5 fields
namestringrequirednipcstringrequiredcitystringrequiredcountrystringrequiredemailstringrequired
instructions_readbooleanrequiredStep 1, the deployer's confirmation (the step is done once an owner also accepted the addendum).
addendumobjectrequiredThe AI features addendum (step 1): the current version and whether it is accepted for Talent insights.
3 fields
versionstringrequiredacceptedbooleanrequiredaccepted_atstring | nullrequired
creditsobjectrequiredAI credits: 1 per person scored per calendar month; paused when none are left (bands kept).
4 fields
per_person_monthintegerrequiredpausedbooleanrequiredpaused_sincestring | nullrequiredleftinteger | nullrequired
modelstringrequiredwould_scoreinteger | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/settings.update \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"informed_other_way_on": "2026-11-10",
"dpia_done_on": "2026-11-12",
"fairness_synthetic_only": true
}'const res = await fetch('https://api.bizisy.com/v1/insights/settings.update', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"informed_other_way_on": "2026-11-10",
"dpia_done_on": "2026-11-12",
"fairness_synthetic_only": 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/insights/settings.update",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"informed_other_way_on": "2026-11-10",
"dpia_done_on": "2026-11-12",
"fairness_synthetic_only": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"enabled": true,
"enabled_at": "2026-11-16T09:00:00.000Z",
"attrition_on": true,
"skills_on": true,
"steps": {
"instructions": true,
"counts": true,
"access": true,
"notice": true,
"dpia": true,
"fairness": true
},
"missing_step": null,
"counted_leave_types": [
"vacation",
"unpaid"
],
"leave_types": [
{
"id": "vacation",
"name": null,
"builtin": true,
"health": false,
"countable": true,
"counted": true,
"locked_reason": null
},
{
"id": "sick",
"name": null,
"builtin": true,
"health": true,
"countable": false,
"counted": false,
"locked_reason": "health"
},
{
"id": "lt1",
"name": "Moving day",
"builtin": false,
"health": false,
"countable": true,
"counted": false,
"locked_reason": null
}
],
"manager_chain": false,
"oversight_roles": [
"owner",
"admin",
"hr"
],
"notice": {
"announcement_id": "an1",
"sent_at": "2026-11-16T09:00:00.000Z",
"informed_other_way_at": null
},
"dpia": {
"confirmed_at": "2026-11-16T09:00:00.000Z",
"done_on": "2026-11-12"
},
"bias_check": {
"last_run_at": "2026-11-16T09:00:00.000Z",
"mode": "synthetic_only",
"result_id": null
},
"backtest": {
"last_run_at": "2026-11-16T09:00:00.000Z",
"result_id": "bt1",
"acknowledged_at": "2026-11-16T09:00:00.000Z",
"done": true,
"waiting": false,
"paused": false
},
"factors": [
{
"id": "F1",
"source": "org",
"available": true
},
{
"id": "F9",
"source": "talent",
"available": false
}
],
"limited_data": false,
"coverage": {
"people": 42,
"scored": 40,
"timeclock_with_records": null
},
"provider": {
"name": "Wisely Lda",
"nipc": "516845128",
"city": "Amares",
"country": "Portugal",
"email": "hello@bizisy.com"
},
"model": "attrition-v1",
"credits": {
"per_person_month": 1,
"paused": false,
"paused_since": null,
"left": 480
},
"instructions_read": true,
"addendum": {
"version": "ai-2",
"accepted": true,
"accepted_at": "2026-11-10T09:00:00.000Z"
},
"would_score": 42
}
}Preview the Talent insights worker notice#
POST/v1/insights/notice.previewRead
The ready announcement for step 4 (AI Act Art. 26(7), GDPR Art. 13): what is used, what is never used, who sees it, the right to object and to an explanation, and a line on consulting workers' representatives where national law requires it. In English, German, Spanish, French, Italian or Portuguese. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
insights_notice_previewon HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
lang"en" | "de" | "es" | "fr" | "it" | "pt"Default
"en".
Returns
lang"en" | "de" | "es" | "fr" | "it" | "pt"requiredtitlestringrequiredbodystringrequiredaudience"everyone"requiredrequires_acktruerequiredlanguages"en" | "de" | "es" | "fr" | "it" | "pt"[]required
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/notice.preview \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"lang":"pt"}'const res = await fetch('https://api.bizisy.com/v1/insights/notice.preview', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"lang": "pt"
}),
});
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/insights/notice.preview",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"lang": "pt",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"lang": "pt",
"title": "How we use Talent insights",
"body": "We are starting…",
"audience": "everyone",
"requires_ack": true,
"languages": [
"en",
"de",
"es",
"fr",
"it",
"pt"
]
}
}Send the Talent insights worker notice#
POST/v1/insights/notice.sendWrite
Step 4: publishes the worker notice as an announcement to everyone, with acknowledgement (new joiners see it too), and records it. In the app only. Owners, admins and HR. The announcement counts towards the company's daily announcement cap.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_notice_sendon 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
lang"en" | "de" | "es" | "fr" | "it" | "pt"Default
"en".
Returns
announcement_idstringrequiredrecipientsintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/notice.send \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"lang":"en"}'const res = await fetch('https://api.bizisy.com/v1/insights/notice.send', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"lang": "en"
}),
});
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/insights/notice.send",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"lang": "en",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"announcement_id": "an1",
"recipients": 42
}
}Download the filled DPIA template#
POST/v1/insights/dpia.downloadRead
Step 5: the data protection impact assessment template (GDPR Art. 35) with the company's settings filled in (oversight roles, counted leave types, manager-chain extension, notice date, the latest back-test), ending with the company's accuracy and fairness record (every back-test with its results and acknowledgement: AI Act documents per deployer), as Markdown to complete and keep. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
insights_dpia_downloadon HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
filenamestringrequiredcontent_type"text/markdown"requiredcontentstringrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/dpia.download \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/dpia.download', {
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/insights/dpia.download",
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": {
"filename": "talent-insights-dpia.md",
"content_type": "text/markdown",
"content": "# DPIA"
}
}Report a problem with Talent insights to the provider#
POST/v1/insights/problems.reportWrite
AI Act Art. 26(5): tells the provider (Wisely Lda) about a risk, a malfunction or a serious incident. Never put people's names or health details in it. Owners, admins and HR, in the app only; 5 a day per company.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_problems_reporton 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
kind"risk" | "malfunction" | "serious_incident" | "other"requireddescriptionstringrequired10–2000 characters.
Returns
reportedtruerequiredreferencestringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/problems.report \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"kind": "malfunction",
"description": "The band did not change after the data was fixed."
}'const res = await fetch('https://api.bizisy.com/v1/insights/problems.report', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"kind": "malfunction",
"description": "The band did not change after the data was fixed."
}),
});
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/insights/problems.report",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"kind": "malfunction",
"description": "The band did not change after the data was fixed.",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"reported": true,
"reference": "TI-20261116-ABC123"
}
}Talent insights: people#
POST/v1/insights/people.listRead
In the app only: API keys and AI assistants are refused. People with an attrition band (Low, Elevated, High or Limited data), their top factor, since when and the review state; default view: unreviewed Elevated and High. 50 per page. Owners, admins and HR; managers only when the company extended insights to the manager chain (their reporting line, pay factors masked). Never a score: a band is a reason to talk, not a decision. Each view is logged.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_people_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
view"unreviewed" | "all"Default
"unreviewed".bands"low" | "elevated" | "high" | "limited"[]Up to 4 items.
review_states"unreviewed" | "acknowledged" | "dismissed" | "overridden"[]Up to 4 items.
unit_idstring1–200 characters.
location_idstring1–200 characters.
title_idstring1–200 characters.
pageintegerFrom 1 to 10000. Default
1.
Returns
9 fields
status"not_set_up" | "off" | "first_run" | "ready"requiredpeopleobject[]required8 fields
person_idstringrequirednamestringrequiredunitstring | nullrequiredband"low" | "elevated" | "high" | "limited"requiredWhat the reviewer sees: the override when a reviewer changed it, else the model band.
model_band"low" | "elevated" | "high" | "limited"requiredtop_factorobject | nullrequired4 fields
idstring (enum)requiredFactor id, or "pay" when a pay-related factor is masked for a manager.
One of:
F1,F2,F3,F4,F5,F6,F7,F8,F9,F10,F11,F12,pay.tier"job" | "pay"requiredevidenceobject | nullrequired3 fields
kindstringrequiredatstring | nullrequiredvaluenumber | nullrequired
conversationstring | nullrequired
sincestringrequiredreview_state"unreviewed" | "acknowledged" | "dismissed" | "overridden"required
totalintegerrequiredpageintegerrequiredpagesintegerrequiredlimited_databooleanrequiredlast_computed_atstring | nullrequiredas_managerbooleanrequiredpaused_no_creditsbooleanrequiredNo AI credits left: the bands shown are the last ones; new ones wait for credits.
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/people.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"view": "all",
"bands": [
"high"
],
"review_states": [
"unreviewed",
"acknowledged"
],
"page": 2
}'const res = await fetch('https://api.bizisy.com/v1/insights/people.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"view": "all",
"bands": [
"high"
],
"review_states": [
"unreviewed",
"acknowledged"
],
"page": 2
}),
});
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/insights/people.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"view": "all",
"bands": [
"high",
],
"review_states": [
"unreviewed",
"acknowledged",
],
"page": 2,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"status": "ready",
"total": 1,
"page": 2,
"pages": 1,
"limited_data": false,
"last_computed_at": "2026-11-16T09:00:00.000Z",
"as_manager": false,
"paused_no_credits": false,
"people": [
{
"person_id": "p3",
"name": "Sofia Costa",
"unit": "Product",
"band": "high",
"model_band": "high",
"top_factor": {
"id": "F3",
"tier": "pay",
"evidence": {
"kind": "last_pay_increase",
"at": "2025-02-01",
"value": 21
},
"conversation": "pay_review"
},
"since": "2026-11-16T09:00:00.000Z",
"review_state": "unreviewed"
}
]
}
}Talent insights: a person's band#
POST/v1/insights/people.getRead
In the app only: API keys and AI assistants are refused. One person's band, why (the factors with the data they came from and its date), suggested conversations, band history, the oversight review and who looked at it. Same access as the list; managers never see pay-related factors. The view is logged. Use it to start a conversation; never tell the person they have a score and never use it alone to decide on pay, promotion, discipline or dismissal.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_people_geton HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
person_idstringrequired1–200 characters.
Returns
16 fields
person_idstringrequirednamestringrequiredunitstring | nullrequiredband"low" | "elevated" | "high" | "limited"requiredmodel_band"low" | "elevated" | "high" | "limited"requiredsincestringrequiredcomputed_atstringrequiredmodelstringrequiredfactorsobject[]required4 fields
idstring (enum)requiredFactor id, or "pay" when a pay-related factor is masked for a manager.
One of:
F1,F2,F3,F4,F5,F6,F7,F8,F9,F10,F11,F12,pay.tier"job" | "pay"requiredevidenceobject | nullrequired3 fields
kindstringrequiredatstring | nullrequiredvaluenumber | nullrequired
conversationstring | nullrequired
availablestring[]requiredlimitedbooleanrequiredhistoryobject[]required2 fields
band"low" | "elevated" | "high" | "limited"requiredonstringrequired
reviewobjectrequired7 fields
state"unreviewed" | "acknowledged" | "dismissed" | "overridden"requiredbystring | nullrequiredatstring | nullrequiredreasonstring | nullrequirednotestring | nullrequiredoverride_band"low" | "elevated" | "high" | "limited"requiredconversation_onstring | nullrequired
can_reviewbooleanrequiredviewedobject[]requiredWho looked at this (the last 20 views).
2 fields
atstringrequiredbystringrequired
as_managerbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/people.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_id":"p3"}'const res = await fetch('https://api.bizisy.com/v1/insights/people.get', {
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/insights/people.get",
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",
"unit": "Product",
"band": "high",
"model_band": "high",
"since": "2026-11-16T09:00:00.000Z",
"computed_at": "2026-11-16T09:00:00.000Z",
"model": "attrition-v1",
"factors": [
{
"id": "F3",
"tier": "pay",
"evidence": {
"kind": "last_pay_increase",
"at": "2025-02-01",
"value": 21
},
"conversation": "pay_review"
},
{
"id": "pay",
"tier": "pay",
"evidence": null,
"conversation": null
}
],
"available": [
"F1",
"F2",
"F3",
"F4",
"F11",
"F12"
],
"limited": false,
"history": [
{
"band": "elevated",
"on": "2026-10-01"
},
{
"band": "high",
"on": "2026-11-16"
}
],
"review": {
"state": "unreviewed",
"by": null,
"at": null,
"reason": null,
"note": null,
"override_band": null,
"conversation_on": null
},
"can_review": true,
"viewed": [
{
"at": "2026-11-16T09:00:00.000Z",
"by": "Ana Ferreira"
}
],
"as_manager": false
}
}Review a talent insight#
POST/v1/insights/reviews.recordWrite
In the app only (API keys and AI assistants are refused), by the company's oversight persons (Art. 14, 26(2)). acknowledge (optionally with a planned conversation day), dismiss (reason: known_and_handled, data_wrong, not_relevant or other with a note) or override (a different band and a note; the model's band stays beside it). Nothing is sent to anyone and nothing changes for the person. Notes ≤ 500 characters; never write health details.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_reviews_recordon 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_idstringrequired1–200 characters.
action"acknowledge" | "dismiss" | "override"requiredreason"known_and_handled" | "data_wrong" | "not_relevant" | "other"notestringUp to 500 characters.
band"low" | "elevated" | "high"conversation_onstringPattern
^\d{4}-\d{2}-\d{2}$.
Returns
person_idstringrequiredreviewobjectrequired7 fields
state"unreviewed" | "acknowledged" | "dismissed" | "overridden"requiredbystring | nullrequiredatstring | nullrequiredreasonstring | nullrequirednotestring | nullrequiredoverride_band"low" | "elevated" | "high" | "limited"requiredconversation_onstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/reviews.record \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"person_id": "p3",
"action": "override",
"band": "low",
"note": "Promotion agreed last week."
}'const res = await fetch('https://api.bizisy.com/v1/insights/reviews.record', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"person_id": "p3",
"action": "override",
"band": "low",
"note": "Promotion agreed last 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/insights/reviews.record",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"person_id": "p3",
"action": "override",
"band": "low",
"note": "Promotion agreed last week.",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"person_id": "p3",
"review": {
"state": "acknowledged",
"by": "m1",
"at": "2026-11-16T09:00:00.000Z",
"reason": null,
"note": null,
"override_band": null,
"conversation_on": "2026-11-20"
}
}
}Recompute talent insights now#
POST/v1/insights/recomputeWrite
In the app only: API keys and AI assistants are refused. Works out bands now for up to 200 people (each person's first band of a calendar month uses 1 AI credit; later bands that month use no more credits; with no credits left nothing new is worked out) and moves the company to the front of the hourly sweep for the rest. Once an hour per company. Owners, admins and HR. Dry run: how many people would be computed.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_recomputeon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
No input: send {}.
Returns
computedintegerrequiredchangedintegerrequiredremainingbooleanrequiredemployedintegerrequiredpaused_no_creditsbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/recompute \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/recompute', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
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, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/insights/recompute",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"computed": 40,
"changed": 3,
"remaining": false,
"employed": 40,
"paused_no_credits": false
}
}Talent insights: people excluded#
POST/v1/insights/exclusions.listRead
In the app only: API keys and AI assistants are refused. People excluded from Talent insights: those who objected (GDPR Art. 21, honoured at once) and those HR excluded, with when. Owners, admins and HR.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_exclusions_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
exclusionsobject[]required6 fields
person_idstringrequirednamestringrequiredreason"objection" | "hr"requirednotestring | nullrequiredatstringrequiredreincluded_atstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/exclusions.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/exclusions.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/insights/exclusions.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": {
"exclusions": [
{
"person_id": "p4",
"name": "Lukas Weber",
"reason": "objection",
"note": null,
"at": "2026-11-16T09:00:00.000Z",
"reincluded_at": null
}
]
}
}Exclude or re-include someone from Talent insights#
POST/v1/insights/exclusions.setWrite
In the app only: API keys and AI assistants are refused. exclude: no band is worked out for the person and their current band is deleted at once (logs stay). include: re-includes them; someone who objected can only be re-included with compelling legitimate grounds written down (GDPR Art. 21(1)), which are logged. Owners, admins and HR. Notes ≤ 500 characters.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_exclusions_seton 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_idstringrequired1–200 characters.
action"exclude" | "include"requirednotestringUp to 500 characters.
groundsstring20–500 characters.
Returns
person_idstringrequiredexcludedbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/exclusions.set \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"person_id": "p4",
"action": "include",
"grounds": "Compelling grounds written down at length."
}'const res = await fetch('https://api.bizisy.com/v1/insights/exclusions.set', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"person_id": "p4",
"action": "include",
"grounds": "Compelling grounds written down at length."
}),
});
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/insights/exclusions.set",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"person_id": "p4",
"action": "include",
"grounds": "Compelling grounds written down at length.",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"person_id": "p4",
"excluded": true
}
}Talent insights: explanation requests#
POST/v1/insights/explanations.listRead
In the app only: API keys and AI assistants are refused. Requests from people for an explanation of a band about them (AI Act Art. 86), open first, with a draft answer from the factors in plain words. Oversight persons only.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_explanations_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
status"open" | "answered" | "all"Default
"open".
Returns
requestsobject[]required9 fields
idstringrequiredperson_idstringrequirednamestringrequiredasked_atstringrequiredquestionstring | nullrequiredstatus"open" | "answered"requiredanswerstring | nullrequiredanswered_atstring | nullrequiredprefillstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/explanations.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"all"}'const res = await fetch('https://api.bizisy.com/v1/insights/explanations.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"status": "all"
}),
});
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/insights/explanations.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"status": "all",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"requests": [
{
"id": "x1",
"person_id": "p3",
"name": "Sofia Costa",
"asked_at": "2026-11-16T09:00:00.000Z",
"question": null,
"status": "open",
"answer": null,
"answered_at": null,
"prefill": "Talent insights currently places you…"
}
]
}
}Answer an explanation request#
POST/v1/insights/explanations.replyWrite
In the app only: API keys and AI assistants are refused. Oversight persons answer a person's request for an explanation (Art. 86) in plain words, ≤ 2000 characters; the person reads it in My workspace → Privacy & data → AI insights. No email. Never write health details.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_explanations_replyon 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
idstringrequired1–200 characters.
answerstringrequired20–2000 characters.
Returns
idstringrequiredstatus"answered"required
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/explanations.reply \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"id": "x1",
"answer": "Two reasons contributed: no pay increase in 18 months and a manager change."
}'const res = await fetch('https://api.bizisy.com/v1/insights/explanations.reply', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"id": "x1",
"answer": "Two reasons contributed: no pay increase in 18 months and a manager change."
}),
});
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/insights/explanations.reply",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"id": "x1",
"answer": "Two reasons contributed: no pay increase in 18 months and a manager change.",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "x1",
"status": "answered"
}
}Talent insights audit log#
POST/v1/insights/audit.listRead
In the app only: API keys and AI assistants are refused. The automatic record (AI Act Art. 12) of every band worked out (model, input aggregates, points, band), every view, review, exclusion, setting change, notice, check and explanation, kept 12 months. Filters by kind, person, who and dates; 50 per page. Owners, admins and HR.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_audit_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
kindsstring (enum)[]One of:
computed,viewed,reviewed,excluded,included,settings_changed,notice_sent,bias_check_run,backtest_run,backtest_acknowledged,explanation_requested,explanation_answered,skill_decided,problem_reported,skill_suggested. Up to 15 items.person_idstring1–200 characters.
actor_person_idstring1–200 characters.
fromstringPattern
^\d{4}-\d{2}-\d{2}$.tostringPattern
^\d{4}-\d{2}-\d{2}$.pageintegerFrom 1 to 10000. Default
1.
Returns
rowsobject[]required7 fields
idstringrequiredatstringrequiredkindstring (enum)requiredOne of:
computed,viewed,reviewed,excluded,included,settings_changed,notice_sent,bias_check_run,backtest_run,backtest_acknowledged,explanation_requested,explanation_answered,skill_decided,problem_reported,skill_suggested.peopleobject[]required2 fields
idstringrequirednamestringrequired
actorstringrequiredsurfacestring | nullrequireddetailobjectrequired
totalintegerrequiredpageintegerrequiredpagesintegerrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/audit.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kinds": [
"viewed",
"reviewed"
],
"from": "2026-11-01",
"to": "2026-11-16",
"page": 1
}'const res = await fetch('https://api.bizisy.com/v1/insights/audit.list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"kinds": [
"viewed",
"reviewed"
],
"from": "2026-11-01",
"to": "2026-11-16",
"page": 1
}),
});
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/insights/audit.list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"kinds": [
"viewed",
"reviewed",
],
"from": "2026-11-01",
"to": "2026-11-16",
"page": 1,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"rows": [
{
"id": "l1",
"at": "2026-11-16T09:00:00.000Z",
"kind": "viewed",
"people": [
{
"id": "p3",
"name": "Sofia Costa"
}
],
"actor": "Ana Ferreira",
"surface": "panel",
"detail": {
"as_manager": false
}
}
],
"total": 1,
"page": 1,
"pages": 1
}
}Download the Talent insights audit log (CSV)#
POST/v1/insights/audit.exportRead
In the app only: API keys and AI assistants are refused. The audit log with the same filters as a CSV, made on download and not stored (up to 5,000 rows). Owners, admins and HR.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_audit_exporton HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
kindsstring (enum)[]One of:
computed,viewed,reviewed,excluded,included,settings_changed,notice_sent,bias_check_run,backtest_run,backtest_acknowledged,explanation_requested,explanation_answered,skill_decided,problem_reported,skill_suggested. Up to 15 items.person_idstring1–200 characters.
actor_person_idstring1–200 characters.
fromstringPattern
^\d{4}-\d{2}-\d{2}$.tostringPattern
^\d{4}-\d{2}-\d{2}$.
Returns
filenamestringrequiredcontent_type"text/csv"requiredcontentstringrequiredrowsintegerrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/audit.export \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kinds":["computed"]}'const res = await fetch('https://api.bizisy.com/v1/insights/audit.export', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"kinds": [
"computed"
]
}),
});
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/insights/audit.export",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"kinds": [
"computed",
],
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"filename": "talent-insights-audit-2026-11-16.csv",
"content_type": "text/csv",
"content": "at,kind",
"rows": 1
}
}Run the Talent insights fairness check#
POST/v1/insights/checks.bias.runWrite
In the app only: API keys and AI assistants are refused. Setup step 6 (AI Act Art. 10, 4a): a CSV of person_id plus any of sex, age_band, nationality_group, for testing only, ≤ 5 MB. Bands are worked out in memory for the people in the file (it runs before switch-on); only rates per group of at least 10 people are kept (ratio to everyone else; outside 0.8–1.25 reads "review"); the file and who is in which group are never stored. 5 runs a day. Owners, admins and HR.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_checks_bias_runon 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
- Body limit
- 5.5 MiB (other actions: 2 MiB)
Input
csvstringrequired1–5242880 characters.
Returns
7 fields
idstringrequiredkind"bias" | "backtest"requiredmodelstringrequiredrun_atstringrequiredgroupsobject[]required6 fields
dimensionstringrequiredgroupstringrequirednintegerrequiredhigh_ratenumberrequiredelevated_ratenumberrequiredrationumberrequired
suppressedintegerrequiredverdict"pass" | "review"required
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled payload_too_large rate_limited internal
curl https://api.bizisy.com/v1/insights/checks.bias.run \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"csv":"person_id,sex\np1,f"}'const res = await fetch('https://api.bizisy.com/v1/insights/checks.bias.run', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"csv": "person_id,sex\np1,f"
}),
});
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/insights/checks.bias.run",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"csv": "person_id,sex\np1,f",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "c1",
"kind": "bias",
"model": "attrition-v1",
"run_at": "2026-11-16T09:00:00.000Z",
"groups": [
{
"dimension": "sex",
"group": "f",
"n": 20,
"high_rate": 0.1,
"elevated_rate": 0.25,
"ratio": 1.05
}
],
"suppressed": 1,
"verdict": "pass"
}
}Talent insights fairness checks#
POST/v1/insights/checks.listRead
Past fairness checks (aggregates only) with their verdicts. Owners, admins and HR, in the app only.
- Web app only
- Refused for API keys and connected apps. Talent insights is used in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_checks_liston HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
checksobject[]required7 fields
idstringrequiredkind"bias" | "backtest"requiredmodelstringrequiredrun_atstringrequiredgroupsobject[]required6 fields
dimensionstringrequiredgroupstringrequirednintegerrequiredhigh_ratenumberrequiredelevated_ratenumberrequiredrationumberrequired
suppressedintegerrequiredverdict"pass" | "review"required
synthetic_reportstringrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/checks.list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/checks.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/insights/checks.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": {
"checks": [
{
"id": "c1",
"kind": "bias",
"model": "attrition-v1",
"run_at": "2026-11-16T09:00:00.000Z",
"groups": [
{
"dimension": "sex",
"group": "f",
"n": 20,
"high_rate": 0.1,
"elevated_rate": 0.25,
"ratio": 1.05
}
],
"suppressed": 1,
"verdict": "pass"
}
],
"synthetic_report": "https://bizisy.com/ai/talent-insights#testing"
}
}Run the Talent insights back-test#
POST/v1/insights/checks.backtest.runWrite
In the app only: API keys and AI assistants are refused. Setup step 6 (AI Act Arts. 9, 10, 15, 26): tests the model on the company's own history. For each voluntary leaver (resignation, retirement) of the last 24 months, the band it gives 90 days before their last day; for everyone employed on those days who did not leave by choice in the 180 days after, the same. Reports recall (leavers flagged Elevated or High), flagged share (stayers flagged), lift, and both by recorded sex and age band (groups of at least 10; ratios outside 0.8–1.25 flagged). Verdict pass, review (no better than chance, or a group flagged) or too_few (under 10 leavers). In memory; only totals are kept. An owner or admin then acknowledges it (insights_checks_backtest_acknowledge). 5 checks a day. Owners, admins and HR.
- Web app only
- Refused for API keys and connected apps. The back-test runs in the Bizisy app, by a person (EU AI Act human oversight).
- MCP tool
insights_checks_backtest_runon 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
No input: send {}.
Returns
17 fields
idstringrequiredmodelstringrequiredrun_atstringrequiredby_systembooleanrequiredwindowobjectrequired2 fields
fromstringrequiredtostringrequired
reference_daysintegerrequiredleaversintegerrequiredVoluntary leavers evaluated (band 90 days before their last day).
stayersintegerrequiredlimitedintegerrequiredPeople left out: fewer than 6 factors had data then.
recallnumberrequiredShare of leavers who were Elevated or High.
flagged_sharenumberrequiredShare of stayers who were Elevated or High (false alarms).
liftnumber | nullrequiredrecall ÷ flagged_share: above 1 is better than chance.
groupsobject[]requiredBy recorded sex and age band, against the other recorded groups; groups under 10 hidden.
9 fields
dimension"sex" | "age_band"requiredgroupstringrequirednintegerrequiredleaversintegerrequiredflagged_sharenumberrequiredrecallnumber | nullrequiredflagged_rationumberrequiredrecall_rationumber | nullrequiredflaggedbooleanrequired
suppressedintegerrequiredrecordedobjectrequired3 fields
sexintegerrequiredage_bandintegerrequiredrowsintegerrequired
verdict"pass" | "review" | "too_few"requiredacknowledgedobject | nullrequired2 fields
bystringrequiredatstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/checks.backtest.run \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/checks.backtest.run', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
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, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/insights/checks.backtest.run",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "bt1",
"model": "attrition-v1",
"run_at": "2026-11-16T09:00:00.000Z",
"by_system": false,
"window": {
"from": "2024-11-16",
"to": "2026-11-16"
},
"reference_days": 14,
"leavers": 23,
"stayers": 812,
"limited": 9,
"recall": 0.565,
"flagged_share": 0.212,
"lift": 2.665,
"groups": [
{
"dimension": "sex",
"group": "female",
"n": 410,
"leavers": 12,
"flagged_share": 0.22,
"recall": 0.583,
"flagged_ratio": 1.08,
"recall_ratio": 1.07,
"flagged": false
}
],
"suppressed": 1,
"recorded": {
"sex": 801,
"age_band": 640,
"rows": 835
},
"verdict": "pass",
"acknowledged": null
}
}Acknowledge the Talent insights back-test#
POST/v1/insights/checks.backtest.acknowledgeWrite
In the app only. Owners and admins: records that the company read the latest back-test (check_id) and accepts it as its accuracy and fairness evidence for using Talent insights per the instructions (AI Act Art. 26). Setup step 6 is done while the acknowledged back-test is the latest and at most 92 days old. A review or too_few verdict can be acknowledged; the record shows it. Refused for an older back-test.
- Web app only
- Refused for API keys and connected apps. An owner or admin acknowledges the back-test in the app only.
- MCP tool
insights_checks_backtest_acknowledgeon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
check_idstringrequired
Returns
17 fields
idstringrequiredmodelstringrequiredrun_atstringrequiredby_systembooleanrequiredwindowobjectrequired2 fields
fromstringrequiredtostringrequired
reference_daysintegerrequiredleaversintegerrequiredVoluntary leavers evaluated (band 90 days before their last day).
stayersintegerrequiredlimitedintegerrequiredPeople left out: fewer than 6 factors had data then.
recallnumberrequiredShare of leavers who were Elevated or High.
flagged_sharenumberrequiredShare of stayers who were Elevated or High (false alarms).
liftnumber | nullrequiredrecall ÷ flagged_share: above 1 is better than chance.
groupsobject[]requiredBy recorded sex and age band, against the other recorded groups; groups under 10 hidden.
9 fields
dimension"sex" | "age_band"requiredgroupstringrequirednintegerrequiredleaversintegerrequiredflagged_sharenumberrequiredrecallnumber | nullrequiredflagged_rationumberrequiredrecall_rationumber | nullrequiredflaggedbooleanrequired
suppressedintegerrequiredrecordedobjectrequired3 fields
sexintegerrequiredage_bandintegerrequiredrowsintegerrequired
verdict"pass" | "review" | "too_few"requiredacknowledgedobject | nullrequired2 fields
bystringrequiredatstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/checks.backtest.acknowledge \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"check_id":"bt1"}'const res = await fetch('https://api.bizisy.com/v1/insights/checks.backtest.acknowledge', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"check_id": "bt1"
}),
});
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/insights/checks.backtest.acknowledge",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"check_id": "bt1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "bt1",
"model": "attrition-v1",
"run_at": "2026-11-16T09:00:00.000Z",
"by_system": false,
"window": {
"from": "2024-11-16",
"to": "2026-11-16"
},
"reference_days": 14,
"leavers": 23,
"stayers": 812,
"limited": 9,
"recall": 0.565,
"flagged_share": 0.212,
"lift": 2.665,
"groups": [
{
"dimension": "sex",
"group": "female",
"n": 410,
"leavers": 12,
"flagged_share": 0.22,
"recall": 0.583,
"flagged_ratio": 1.08,
"recall_ratio": 1.07,
"flagged": false
}
],
"suppressed": 1,
"recorded": {
"sex": 801,
"age_band": 640,
"rows": 835
},
"verdict": "pass",
"acknowledged": {
"by": "m1",
"at": "2026-11-16T09:00:00.000Z"
}
}
}The latest Talent insights back-test#
POST/v1/insights/checks.backtest.getRead
The latest back-test (totals only) and whether it is acknowledged, or null before the first run. Owners, admins and HR, in the app only.
- Web app only
- Refused for API keys and connected apps. Back-test results are read in the app only.
- MCP tool
insights_checks_backtest_geton HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
backtestobject | nullrequired17 fields
idstringrequiredmodelstringrequiredrun_atstringrequiredby_systembooleanrequiredwindowobjectrequired2 fields
fromstringrequiredtostringrequired
reference_daysintegerrequiredleaversintegerrequiredVoluntary leavers evaluated (band 90 days before their last day).
stayersintegerrequiredlimitedintegerrequiredPeople left out: fewer than 6 factors had data then.
recallnumberrequiredShare of leavers who were Elevated or High.
flagged_sharenumberrequiredShare of stayers who were Elevated or High (false alarms).
liftnumber | nullrequiredrecall ÷ flagged_share: above 1 is better than chance.
groupsobject[]requiredBy recorded sex and age band, against the other recorded groups; groups under 10 hidden.
9 fields
dimension"sex" | "age_band"requiredgroupstringrequirednintegerrequiredleaversintegerrequiredflagged_sharenumberrequiredrecallnumber | nullrequiredflagged_rationumberrequiredrecall_rationumber | nullrequiredflaggedbooleanrequired
suppressedintegerrequiredrecordedobjectrequired3 fields
sexintegerrequiredage_bandintegerrequiredrowsintegerrequired
verdict"pass" | "review" | "too_few"requiredacknowledgedobject | nullrequired2 fields
bystringrequiredatstringrequired
valid_daysintegerrequiredack_daysintegerrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/checks.backtest.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/checks.backtest.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/insights/checks.backtest.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": {
"backtest": {
"id": "bt1",
"model": "attrition-v1",
"run_at": "2026-11-16T09:00:00.000Z",
"by_system": false,
"window": {
"from": "2024-11-16",
"to": "2026-11-16"
},
"reference_days": 14,
"leavers": 23,
"stayers": 812,
"limited": 9,
"recall": 0.565,
"flagged_share": 0.212,
"lift": 2.665,
"groups": [
{
"dimension": "sex",
"group": "female",
"n": 410,
"leavers": 12,
"flagged_share": 0.22,
"recall": 0.583,
"flagged_ratio": 1.08,
"recall_ratio": 1.07,
"flagged": false
}
],
"suppressed": 1,
"recorded": {
"sex": 801,
"age_band": 640,
"rows": 835
},
"verdict": "pass",
"acknowledged": null
},
"valid_days": 92,
"ack_days": 30
}
}Something missing or wrong on this page? Write to hello@bizisy.com.