Skip to content

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

Input

No input: send {}.

Returns

22 fields
  • enabledbooleanrequired
  • enabled_atstring | nullrequired
  • attrition_onbooleanrequired
  • skills_onbooleanrequired
  • stepsobjectrequired
    6 fields
    • instructionsbooleanrequired
    • countsbooleanrequired
    • accessbooleanrequired
    • noticebooleanrequired
    • dpiabooleanrequired
    • fairnessbooleanrequired
  • missing_step"instructions" | "counts" | "access" | "notice" | "dpia" | "fairness"required
  • counted_leave_typesstring[]required
  • leave_typesobject[] | nullrequired
    7 fields
    • idstringrequired
    • namestring | nullrequired
    • builtinbooleanrequired
    • healthbooleanrequired
    • countablebooleanrequired
    • countedbooleanrequired
    • locked_reason"health" | "parental" | "away_only"required
  • manager_chainbooleanrequired
  • oversight_roles"owner" | "admin" | "hr"[]required
  • noticeobjectrequired
    3 fields
    • announcement_idstring | nullrequired
    • sent_atstring | nullrequired
    • informed_other_way_atstring | nullrequired
  • dpiaobjectrequired
    2 fields
    • confirmed_atstring | nullrequired
    • done_onstring | nullrequired
  • bias_checkobjectrequired

    The optional uploaded-groups fairness check.

    3 fields
    • last_run_atstring | nullrequired
    • mode"synthetic_only" | "deployer"required
    • result_idstring | nullrequired
  • backtestobjectrequired

    The back-test on the company's own history (addendum B).

    6 fields
    • last_run_atstring | nullrequired
    • result_idstring | nullrequired
    • acknowledged_atstring | nullrequired
    • donebooleanrequired

      Step 6: the latest back-test is acknowledged and at most 92 days old.

    • waitingbooleanrequired

      The latest back-test waits for an owner or admin to acknowledge it.

    • pausedbooleanrequired

      Unacknowledged for over 30 days: new bands wait until it is acknowledged.

  • factorsobject[]required
    3 fields
    • idstringrequired
    • sourcestringrequired
    • availablebooleanrequired
  • limited_databooleanrequired
  • coverageobject | nullrequired
    3 fields
    • peopleintegerrequired
    • scoredintegerrequired
    • timeclock_with_recordsinteger | nullrequired
  • providerobjectrequired
    5 fields
    • namestringrequired
    • nipcstringrequired
    • citystringrequired
    • countrystringrequired
    • emailstringrequired
  • instructions_readbooleanrequired

    Step 1, the deployer's confirmation (the step is done once an owner also accepted the addendum).

  • addendumobjectrequired

    The AI features addendum (step 1): the current version and whether it is accepted for Talent insights.

    3 fields
    • versionstringrequired
    • acceptedbooleanrequired
    • accepted_atstring | nullrequired
  • creditsobjectrequired

    AI credits: 1 per person scored per calendar month; paused when none are left (bands kept).

    4 fields
    • per_person_monthintegerrequired
    • pausedbooleanrequired
    • paused_sincestring | nullrequired
    • leftinteger | nullrequired
  • modelstringrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/settings.get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_update on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • accept_addendumobject

    Step 1, on the same screen: accept the AI features addendum to the data processing agreement (platform_ai_addendum_get shows its text), the version read. Owners only (as the data processing agreement); an admin asks an owner (platform_ai_addendum_request).

    2 fields
    • versionstringrequired
    • lang"en" | "de" | "es" | "fr" | "it" | "pt"

      Default "en".

  • instructions_readtrue

    Step 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_countstrue
  • manager_chainboolean

    Step 3: extend bands and job-tier factors to the person's manager chain (needs confirm_warning: true to switch on).

  • confirm_warningboolean
  • oversight_roles"owner" | "admin" | "hr"[]

    Step 3: the built-in roles that record reviews and answer explanation requests (Art. 26(2)).

    1–3 items.

  • confirm_accesstrue
  • informed_other_way_onstring

    Step 4, instead of sending the announcement: the day people were informed another way.

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • dpia_done_onstring

    Step 5: the day the DPIA was completed.

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • fairness_synthetic_onlytrue

    No 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.

  • enabledboolean

    Step 7: the switch. On needs steps 1–6; off hides bands at once, deletes current bands and stops the sweep (logs stay).

  • attrition_onboolean
  • skills_onboolean

Returns

23 fields
  • enabledbooleanrequired
  • enabled_atstring | nullrequired
  • attrition_onbooleanrequired
  • skills_onbooleanrequired
  • stepsobjectrequired
    6 fields
    • instructionsbooleanrequired
    • countsbooleanrequired
    • accessbooleanrequired
    • noticebooleanrequired
    • dpiabooleanrequired
    • fairnessbooleanrequired
  • missing_step"instructions" | "counts" | "access" | "notice" | "dpia" | "fairness"required
  • counted_leave_typesstring[]required
  • leave_typesobject[] | nullrequired
    7 fields
    • idstringrequired
    • namestring | nullrequired
    • builtinbooleanrequired
    • healthbooleanrequired
    • countablebooleanrequired
    • countedbooleanrequired
    • locked_reason"health" | "parental" | "away_only"required
  • manager_chainbooleanrequired
  • oversight_roles"owner" | "admin" | "hr"[]required
  • noticeobjectrequired
    3 fields
    • announcement_idstring | nullrequired
    • sent_atstring | nullrequired
    • informed_other_way_atstring | nullrequired
  • dpiaobjectrequired
    2 fields
    • confirmed_atstring | nullrequired
    • done_onstring | nullrequired
  • bias_checkobjectrequired

    The optional uploaded-groups fairness check.

    3 fields
    • last_run_atstring | nullrequired
    • mode"synthetic_only" | "deployer"required
    • result_idstring | nullrequired
  • backtestobjectrequired

    The back-test on the company's own history (addendum B).

    6 fields
    • last_run_atstring | nullrequired
    • result_idstring | nullrequired
    • acknowledged_atstring | nullrequired
    • donebooleanrequired

      Step 6: the latest back-test is acknowledged and at most 92 days old.

    • waitingbooleanrequired

      The latest back-test waits for an owner or admin to acknowledge it.

    • pausedbooleanrequired

      Unacknowledged for over 30 days: new bands wait until it is acknowledged.

  • factorsobject[]required
    3 fields
    • idstringrequired
    • sourcestringrequired
    • availablebooleanrequired
  • limited_databooleanrequired
  • coverageobject | nullrequired
    3 fields
    • peopleintegerrequired
    • scoredintegerrequired
    • timeclock_with_recordsinteger | nullrequired
  • providerobjectrequired
    5 fields
    • namestringrequired
    • nipcstringrequired
    • citystringrequired
    • countrystringrequired
    • emailstringrequired
  • instructions_readbooleanrequired

    Step 1, the deployer's confirmation (the step is done once an owner also accepted the addendum).

  • addendumobjectrequired

    The AI features addendum (step 1): the current version and whether it is accepted for Talent insights.

    3 fields
    • versionstringrequired
    • acceptedbooleanrequired
    • accepted_atstring | nullrequired
  • creditsobjectrequired

    AI credits: 1 per person scored per calendar month; paused when none are left (bands kept).

    4 fields
    • per_person_monthintegerrequired
    • pausedbooleanrequired
    • paused_sincestring | nullrequired
    • leftinteger | nullrequired
  • modelstringrequired
  • would_scoreinteger | nullrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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
}'
Response
{
  "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_preview on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • lang"en" | "de" | "es" | "fr" | "it" | "pt"

    Default "en".

Returns

  • lang"en" | "de" | "es" | "fr" | "it" | "pt"required
  • titlestringrequired
  • bodystringrequired
  • audience"everyone"required
  • requires_acktruerequired
  • languages"en" | "de" | "es" | "fr" | "it" | "pt"[]required

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/notice.preview \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"pt"}'
Response
{
  "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_send on HR Assistant
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

  • lang"en" | "de" | "es" | "fr" | "it" | "pt"

    Default "en".

Returns

  • announcement_idstringrequired
  • recipientsintegerrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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"}'
Response
{
  "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_download on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • filenamestringrequired
  • content_type"text/markdown"required
  • contentstringrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/dpia.download \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_report on HR Assistant
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

  • kind"risk" | "malfunction" | "serious_incident" | "other"required
  • descriptionstringrequired

    10–2000 characters.

Returns

  • reportedtruerequired
  • referencestringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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."
}'
Response
{
  "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_list on HR Assistant
Method
POST with a JSON body, or GET with 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_idstring

    1–200 characters.

  • location_idstring

    1–200 characters.

  • title_idstring

    1–200 characters.

  • pageinteger

    From 1 to 10000. Default 1.

Returns

9 fields
  • status"not_set_up" | "off" | "first_run" | "ready"required
  • peopleobject[]required
    8 fields
    • person_idstringrequired
    • namestringrequired
    • unitstring | nullrequired
    • band"low" | "elevated" | "high" | "limited"required

      What the reviewer sees: the override when a reviewer changed it, else the model band.

    • model_band"low" | "elevated" | "high" | "limited"required
    • top_factorobject | nullrequired
      4 fields
      • idstring (enum)required

        Factor 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"required
      • evidenceobject | nullrequired
        3 fields
        • kindstringrequired
        • atstring | nullrequired
        • valuenumber | nullrequired
      • conversationstring | nullrequired
    • sincestringrequired
    • review_state"unreviewed" | "acknowledged" | "dismissed" | "overridden"required
  • totalintegerrequired
  • pageintegerrequired
  • pagesintegerrequired
  • limited_databooleanrequired
  • last_computed_atstring | nullrequired
  • as_managerbooleanrequired
  • paused_no_creditsbooleanrequired

    No 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
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
}'
Response
{
  "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_get on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • person_idstringrequired

    1–200 characters.

Returns

16 fields
  • person_idstringrequired
  • namestringrequired
  • unitstring | nullrequired
  • band"low" | "elevated" | "high" | "limited"required
  • model_band"low" | "elevated" | "high" | "limited"required
  • sincestringrequired
  • computed_atstringrequired
  • modelstringrequired
  • factorsobject[]required
    4 fields
    • idstring (enum)required

      Factor 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"required
    • evidenceobject | nullrequired
      3 fields
      • kindstringrequired
      • atstring | nullrequired
      • valuenumber | nullrequired
    • conversationstring | nullrequired
  • availablestring[]required
  • limitedbooleanrequired
  • historyobject[]required
    2 fields
    • band"low" | "elevated" | "high" | "limited"required
    • onstringrequired
  • reviewobjectrequired
    7 fields
    • state"unreviewed" | "acknowledged" | "dismissed" | "overridden"required
    • bystring | nullrequired
    • atstring | nullrequired
    • reasonstring | nullrequired
    • notestring | nullrequired
    • override_band"low" | "elevated" | "high" | "limited"required
    • conversation_onstring | nullrequired
  • can_reviewbooleanrequired
  • viewedobject[]required

    Who looked at this (the last 20 views).

    2 fields
    • atstringrequired
    • bystringrequired
  • as_managerbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/people.get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person_id":"p3"}'
Response
{
  "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_record on HR Assistant
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

  • person_idstringrequired

    1–200 characters.

  • action"acknowledge" | "dismiss" | "override"required
  • reason"known_and_handled" | "data_wrong" | "not_relevant" | "other"
  • notestring

    Up to 500 characters.

  • band"low" | "elevated" | "high"
  • conversation_onstring

    Pattern ^\d{4}-\d{2}-\d{2}$.

Returns

  • person_idstringrequired
  • reviewobjectrequired
    7 fields
    • state"unreviewed" | "acknowledged" | "dismissed" | "overridden"required
    • bystring | nullrequired
    • atstring | nullrequired
    • reasonstring | nullrequired
    • notestring | nullrequired
    • override_band"low" | "elevated" | "high" | "limited"required
    • conversation_onstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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."
}'
Response
{
  "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_recompute on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

No input: send {}.

Returns

  • computedintegerrequired
  • changedintegerrequired
  • remainingbooleanrequired
  • employedintegerrequired
  • paused_no_creditsbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/recompute \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'
Response
{
  "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_list on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • exclusionsobject[]required
    6 fields
    • person_idstringrequired
    • namestringrequired
    • reason"objection" | "hr"required
    • notestring | nullrequired
    • atstringrequired
    • reincluded_atstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/exclusions.list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_set on HR Assistant
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

  • person_idstringrequired

    1–200 characters.

  • action"exclude" | "include"required
  • notestring

    Up to 500 characters.

  • groundsstring

    20–500 characters.

Returns

  • person_idstringrequired
  • excludedbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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."
}'
Response
{
  "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_list on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • status"open" | "answered" | "all"

    Default "open".

Returns

  • requestsobject[]required
    9 fields
    • idstringrequired
    • person_idstringrequired
    • namestringrequired
    • asked_atstringrequired
    • questionstring | nullrequired
    • status"open" | "answered"required
    • answerstring | nullrequired
    • answered_atstring | nullrequired
    • prefillstring | nullrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/explanations.list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"all"}'
Response
{
  "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_reply on HR Assistant
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

  • idstringrequired

    1–200 characters.

  • answerstringrequired

    20–2000 characters.

Returns

  • idstringrequired
  • status"answered"required

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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."
}'
Response
{
  "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_list on HR Assistant
Method
POST with a JSON body, or GET with 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_idstring

    1–200 characters.

  • actor_person_idstring

    1–200 characters.

  • fromstring

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • tostring

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • pageinteger

    From 1 to 10000. Default 1.

Returns

  • rowsobject[]required
    7 fields
    • idstringrequired
    • atstringrequired
    • kindstring (enum)required

      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.

    • peopleobject[]required
      2 fields
      • idstringrequired
      • namestringrequired
    • actorstringrequired
    • surfacestring | nullrequired
    • detailobjectrequired
  • totalintegerrequired
  • pageintegerrequired
  • pagesintegerrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
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
}'
Response
{
  "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_export on HR Assistant
Method
POST with a JSON body, or GET with 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_idstring

    1–200 characters.

  • actor_person_idstring

    1–200 characters.

  • fromstring

    Pattern ^\d{4}-\d{2}-\d{2}$.

  • tostring

    Pattern ^\d{4}-\d{2}-\d{2}$.

Returns

  • filenamestringrequired
  • content_type"text/csv"required
  • contentstringrequired
  • rowsintegerrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/audit.export \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kinds":["computed"]}'
Response
{
  "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_run on HR Assistant
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
Body limit
5.5 MiB (other actions: 2 MiB)

Input

  • csvstringrequired

    1–5242880 characters.

Returns

7 fields
  • idstringrequired
  • kind"bias" | "backtest"required
  • modelstringrequired
  • run_atstringrequired
  • groupsobject[]required
    6 fields
    • dimensionstringrequired
    • groupstringrequired
    • nintegerrequired
    • high_ratenumberrequired
    • elevated_ratenumberrequired
    • rationumberrequired
  • suppressedintegerrequired
  • verdict"pass" | "review"required

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled payload_too_large rate_limited internal

curl
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"}'
Response
{
  "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_list on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • checksobject[]required
    7 fields
    • idstringrequired
    • kind"bias" | "backtest"required
    • modelstringrequired
    • run_atstringrequired
    • groupsobject[]required
      6 fields
      • dimensionstringrequired
      • groupstringrequired
      • nintegerrequired
      • high_ratenumberrequired
      • elevated_ratenumberrequired
      • rationumberrequired
    • suppressedintegerrequired
    • verdict"pass" | "review"required
  • synthetic_reportstringrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/checks.list \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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_run on HR Assistant
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

No input: send {}.

Returns

17 fields
  • idstringrequired
  • modelstringrequired
  • run_atstringrequired
  • by_systembooleanrequired
  • windowobjectrequired
    2 fields
    • fromstringrequired
    • tostringrequired
  • reference_daysintegerrequired
  • leaversintegerrequired

    Voluntary leavers evaluated (band 90 days before their last day).

  • stayersintegerrequired
  • limitedintegerrequired

    People left out: fewer than 6 factors had data then.

  • recallnumberrequired

    Share of leavers who were Elevated or High.

  • flagged_sharenumberrequired

    Share of stayers who were Elevated or High (false alarms).

  • liftnumber | nullrequired

    recall ÷ flagged_share: above 1 is better than chance.

  • groupsobject[]required

    By recorded sex and age band, against the other recorded groups; groups under 10 hidden.

    9 fields
    • dimension"sex" | "age_band"required
    • groupstringrequired
    • nintegerrequired
    • leaversintegerrequired
    • flagged_sharenumberrequired
    • recallnumber | nullrequired
    • flagged_rationumberrequired
    • recall_rationumber | nullrequired
    • flaggedbooleanrequired
  • suppressedintegerrequired
  • recordedobjectrequired
    3 fields
    • sexintegerrequired
    • age_bandintegerrequired
    • rowsintegerrequired
  • verdict"pass" | "review" | "too_few"required
  • acknowledgedobject | nullrequired
    2 fields
    • bystringrequired
    • atstringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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 '{}'
Response
{
  "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_acknowledge on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • check_idstringrequired

Returns

17 fields
  • idstringrequired
  • modelstringrequired
  • run_atstringrequired
  • by_systembooleanrequired
  • windowobjectrequired
    2 fields
    • fromstringrequired
    • tostringrequired
  • reference_daysintegerrequired
  • leaversintegerrequired

    Voluntary leavers evaluated (band 90 days before their last day).

  • stayersintegerrequired
  • limitedintegerrequired

    People left out: fewer than 6 factors had data then.

  • recallnumberrequired

    Share of leavers who were Elevated or High.

  • flagged_sharenumberrequired

    Share of stayers who were Elevated or High (false alarms).

  • liftnumber | nullrequired

    recall ÷ flagged_share: above 1 is better than chance.

  • groupsobject[]required

    By recorded sex and age band, against the other recorded groups; groups under 10 hidden.

    9 fields
    • dimension"sex" | "age_band"required
    • groupstringrequired
    • nintegerrequired
    • leaversintegerrequired
    • flagged_sharenumberrequired
    • recallnumber | nullrequired
    • flagged_rationumberrequired
    • recall_rationumber | nullrequired
    • flaggedbooleanrequired
  • suppressedintegerrequired
  • recordedobjectrequired
    3 fields
    • sexintegerrequired
    • age_bandintegerrequired
    • rowsintegerrequired
  • verdict"pass" | "review" | "too_few"required
  • acknowledgedobject | nullrequired
    2 fields
    • bystringrequired
    • atstringrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
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"}'
Response
{
  "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_get on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

No input: send {}.

Returns

  • backtestobject | nullrequired
    17 fields
    • idstringrequired
    • modelstringrequired
    • run_atstringrequired
    • by_systembooleanrequired
    • windowobjectrequired
      2 fields
      • fromstringrequired
      • tostringrequired
    • reference_daysintegerrequired
    • leaversintegerrequired

      Voluntary leavers evaluated (band 90 days before their last day).

    • stayersintegerrequired
    • limitedintegerrequired

      People left out: fewer than 6 factors had data then.

    • recallnumberrequired

      Share of leavers who were Elevated or High.

    • flagged_sharenumberrequired

      Share of stayers who were Elevated or High (false alarms).

    • liftnumber | nullrequired

      recall ÷ flagged_share: above 1 is better than chance.

    • groupsobject[]required

      By recorded sex and age band, against the other recorded groups; groups under 10 hidden.

      9 fields
      • dimension"sex" | "age_band"required
      • groupstringrequired
      • nintegerrequired
      • leaversintegerrequired
      • flagged_sharenumberrequired
      • recallnumber | nullrequired
      • flagged_rationumberrequired
      • recall_rationumber | nullrequired
      • flaggedbooleanrequired
    • suppressedintegerrequired
    • recordedobjectrequired
      3 fields
      • sexintegerrequired
      • age_bandintegerrequired
      • rowsintegerrequired
    • verdict"pass" | "review" | "too_few"required
    • acknowledgedobject | nullrequired
      2 fields
      • bystringrequired
      • atstringrequired
  • valid_daysintegerrequired
  • ack_daysintegerrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/insights/checks.backtest.get \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response
{
  "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.

Developer docs