API reference
AI insights about me
Whether a person's company uses Talent insights, the notice, their status, objecting and asking for an explanation (objecting and asking are in the app only). Never the band.
3 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
AI insights about me#
POST/v1/insights/me.getRead
Whether your company uses Talent insights, the notice it sent, whether you are included or excluded (objected), and your latest explanation request with its answer. Never your band: the band is only in your data download (GDPR access).
- Who can call it
- Me key owner admin hr member
- MCP tool
insights_me_geton My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
usedbooleanrequiredWhether the company uses Talent insights (switched on and announced).
noticeobject | nullrequired2 fields
titlestringrequiredbodystringrequired
status"included" | "excluded" | "objected"requiredexplanationobject | nullrequired6 fields
idstringrequiredstatus"open" | "answered"requiredasked_atstringrequiredquestionstring | nullrequiredanswerstring | nullrequiredanswered_atstring | nullrequired
can_askbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/me.get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/insights/me.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/me.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": {
"used": true,
"notice": {
"title": "How we use Talent insights",
"body": "We are starting…"
},
"status": "included",
"explanation": {
"id": "x1",
"status": "answered",
"asked_at": "2026-11-16T09:00:00.000Z",
"question": null,
"answer": "Two reasons…",
"answered_at": "2026-11-16T09:00:00.000Z"
},
"can_ask": true
}
}Object to Talent insights about me#
POST/v1/insights/me.objectWrite
GDPR Art. 21: you are excluded from Talent insights at once: no band is worked out for you and any current one is deleted (the record of past computations stays for 12 months, as the law requires). In the app only, by you. Objecting again while objected changes nothing.
- Web app only
- Refused for API keys and connected apps. An objection is the person's own click in My workspace.
- MCP tool
insights_me_objecton My Workplace- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
notestringUp to 500 characters.
Returns
status"objected"required
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/me.object \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"note":"I prefer not to."}'const res = await fetch('https://api.bizisy.com/v1/insights/me.object', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"note": "I prefer not to."
}),
});
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/me.object",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"note": "I prefer not to.",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"status": "objected"
}
}Ask for an explanation of AI insights about me#
POST/v1/insights/me.explanation.askWrite
AI Act Art. 86: asks HR to explain any band worked out about you. HR answers in My workspace → Privacy & data → AI insights. One open request at a time, 3 in 30 days; a question ≤ 500 characters is optional. In the app only, by you.
- Web app only
- Refused for API keys and connected apps. Asking for an explanation is the person's own click in My workspace.
- MCP tool
insights_me_explanation_askon My Workplace- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
questionstringUp to 500 characters.
Returns
idstringrequiredstatus"open"required
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/insights/me.explanation.ask \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"question":"Why?"}'const res = await fetch('https://api.bizisy.com/v1/insights/me.explanation.ask', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"question": "Why?"
}),
});
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/me.explanation.ask",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"question": "Why?",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "x1",
"status": "open"
}
}Something missing or wrong on this page? Write to hello@bizisy.com.