Skip to content

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_get on My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • usedbooleanrequired

    Whether the company uses Talent insights (switched on and announced).

  • noticeobject | nullrequired
    2 fields
    • titlestringrequired
    • bodystringrequired
  • status"included" | "excluded" | "objected"required
  • explanationobject | nullrequired
    6 fields
    • idstringrequired
    • status"open" | "answered"required
    • asked_atstringrequired
    • questionstring | nullrequired
    • answerstring | nullrequired
    • answered_atstring | nullrequired
  • can_askbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/me.get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_object on My Workplace
Preview
?dry_run=true runs 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

  • notestring

    Up to 500 characters.

Returns

  • status"objected"required

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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."}'
Response
{
  "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_ask on My Workplace
Preview
?dry_run=true runs 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

  • questionstring

    Up to 500 characters.

Returns

  • idstringrequired
  • status"open"required

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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?"}'
Response
{
  "data": {
    "id": "x1",
    "status": "open"
  }
}

Something missing or wrong on this page? Write to hello@bizisy.com.

Developer docs