Skip to content

API reference

Find talent and endorsements

Search people by the skills, studies, courses and certificates on their talent profiles (API keys and AI apps get the colleague view only: profiles shown to colleagues), the search vocabulary, HR's CSV and index rebuild (in the app), and colleagues' skill confirmations ("I've worked with this", given in the app). Whether anyone is open to a new role is never available to API keys or AI apps. Internal candidates for a job ("Look inside first": criteria with reasons, never a score) are for HR in the app only.

9 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.

Suggestions for Find talent#

POST/v1/talent/search.vocabRead

What to search for as you type (q, at least 1 character): up to 8 each of the company's skills, training courses and certificate names people hold that contain the text (certificate names: owners, admins and HR in the app see every one; everyone else and every API key or AI app only names on profiles shown to colleagues). Use the ids as chips for talent_search_people (skill, course, credential); studies use ISCED-F field codes (e.g. 0411 Accounting and taxation). Anyone who can search (Find talent on).

Who can call it
Manage key owner admin hr
Me key owner admin hr member
MCP tool
talent_search_vocab on My Workplace, HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • qstringrequired

    1–80 characters.

Returns

  • skillsobject[]required
    3 fields
    • idstringrequired
    • namestringrequired
    • categorystringrequired
  • coursesobject[]required
    2 fields
    • idstringrequired
    • titlestringrequired
  • credentialsobject[]required
    2 fields
    • keystringrequired
    • labelstringrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/search.vocab \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"acc"}'
Response
{
  "data": {
    "skills": [
      {
        "id": "s1",
        "name": "Accounting",
        "category": "Finance"
      }
    ],
    "courses": [
      {
        "id": "c1",
        "title": "Accounting basics"
      }
    ],
    "credentials": [
      {
        "key": "acca",
        "label": "ACCA"
      }
    ]
  }
}

Find talent#

POST/v1/talent/search.peopleRead

Finds people by what they, their managers and HR recorded: chips (all must match, at most 8; at least one that isn't "open"): skill at least a level, studies by ISCED-F field or ISCED level (done, in_progress or any), a course, a certificate, a word in a qualification, certificate or earlier role; plus filters by location, team (with the teams under it), title, legal entity and months in the job. Who sees whom: owners, admins and HR everyone working here (as: colleagues searches as a colleague does); managers profiles shown to colleagues plus their reports; everyone else, and every API key or AI app, only profiles people chose to show to colleagues. "open" (open to a new role) is for owners, admins and HR in the app only and never shows people in your own manager chain. Each result lists the reasons (what matched, with levels and colleagues' confirmations); the order is the sum of the skill chips' levels, then name — no score, people decide. 50 a page (offset); the narrowest chip is read up to 2000 people (broad true beyond). Off unless Find talent is on (Settings → Talent → Talent profiles).

Who can call it
Manage key owner admin hr
Me key owner admin hr member
Keys and apps
The colleague view only (profiles shown to colleagues), even with HR's key; never "open to a new role" (the open chip is refused).
MCP tool
talent_search_people on My Workplace, HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • chipsobject[]required

    1–8 items.

    16 fields (one of several shapes)

    Option 1

    • kind"skill"required
    • skill_idstringrequired

      1–200 characters.

    • min_levelinteger

      At least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.

      From 1 to 4. Default 1.

    Option 2

    • kind"field"required
    • codestringrequired

      ISCED-F 2013 field: broad (2 digits, e.g. 04 Business, administration and law) or narrow (4, e.g. 0411 Accounting and taxation).

      Pattern ^\d{2}(\d{2})?$.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 3

    • kind"level"required
    • min_levelintegerrequired

      ISCED 2011 level at least: 3 upper secondary … 6 bachelor's, 7 master's, 8 doctoral.

      From 1 to 8.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 4

    • kind"course"required
    • course_idstringrequired

      A training course id (talent_search_vocab).

      1–200 characters.

    Option 5

    • kind"credential"required
    • keystringrequired

      A certificate name key from talent_search_vocab.

      1–120 characters.

    Option 6

    • kind"word"required
    • wordstringrequired

      One word in a qualification, certificate or earlier role title.

      2–40 characters.

    Option 7

    • kind"open"required

      Open to a new role: owners, admins and HR only, in the app; never shows people in your own manager chain.

  • filtersobject
    5 fields
    • location_idsstring[]

      1–200 characters. Up to 20 items.

    • unit_idsstring[]

      Teams, with the teams under them.

      1–200 characters. Up to 20 items.

    • title_idsstring[]

      1–200 characters. Up to 20 items.

    • legal_entity_idsstring[]

      1–200 characters. Up to 20 items.

    • min_months_in_jobinteger

      At least this many months in their current title.

      From 0 to 600.

  • as"colleagues"

    colleagues: search as a colleague does, even as HR (My workspace).

  • offsetinteger

    From 0 to 2000. Default 0.

Returns

9 fields
  • scope"hr" | "manager" | "colleague"required

    hr: everyone working here; manager: profiles shown to colleagues plus your reports; colleague: profiles shown to colleagues.

  • chipsobject[]required

    Per chip as given: how many people in your view match it alone (more: over the read cap). Openness counts leave out your own chain.

    2 fields
    • countintegerrequired
    • morebooleanrequired
  • totalintegerrequired

    People who meet every chip and filter (of the first 2,000 read when broad).

  • broadbooleanrequired

    The narrowest chip matched more than 2000 people: only the first 2000 were checked. Add a chip to narrow it.

  • order"levels_then_name"required

    The sum of the levels of the skill chips (highest first), then name. No score.

  • peopleobject[]required
    4 fields
    • personobjectrequired
      5 fields
      • idstringrequired
      • namestringrequired
      • titlestring | nullrequired
      • unitstring | nullrequired
      • locationstring | nullrequired
    • months_in_jobinteger | nullrequired
    • reasonsobject[]required

      Each chip this person meets, with what matched (the order of the chips).

      19 fields (one of several shapes)

      Option 1

      • kind"skill"required
      • skill_idstringrequired
      • namestringrequired
      • levelintegerrequired
      • endorsementsintegerrequired

        Colleagues who confirmed it ("I've worked with this").

      Option 2

      • kind"field"required
      • codestringrequired
      • status"done" | "in_progress" | "paused"required

      Option 3

      • kind"level"required
      • levelintegerrequired
      • status"done" | "in_progress" | "paused"required

      Option 4

      • kind"course"required
      • course_idstringrequired
      • titlestringrequired

      Option 5

      • kind"credential"required
      • namestringrequired

      Option 6

      • kind"word"required
      • wordstringrequired

      Option 7

      • kind"open"required
    • openobject | nullrequired

      Open to a new role, as the person told HR: owners, admins and HR in the app only, never for people in your manager chain; null otherwise.

      4 fields
      • kindsstring[]required
      • locationsstring[]required
      • fromstring | nullrequired
      • notestringrequired
  • next_offsetinteger | nullrequired
  • indexobject | nullrequired

    HR only: the index is behind (rebuild in Settings → Talent → Talent profiles).

    2 fields
    • stalebooleanrequired
    • rebuildingbooleanrequired
  • reports_cappedbooleanrequired

    A manager with more than 2,000 reports: only the first 2,000 were checked.

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/search.people \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chips": [
    {
      "kind": "field",
      "code": "04",
      "status": "in_progress"
    },
    {
      "kind": "level",
      "min_level": 6
    },
    {
      "kind": "course",
      "course_id": "c1"
    },
    {
      "kind": "credential",
      "key": "csm"
    },
    {
      "kind": "word",
      "word": "contabilidade"
    },
    {
      "kind": "open"
    }
  ],
  "filters": {
    "location_ids": [
      "l1"
    ],
    "unit_ids": [
      "u1"
    ],
    "title_ids": [
      "t1"
    ],
    "legal_entity_ids": [
      "le1"
    ],
    "min_months_in_job": 6
  },
  "offset": 50
}'
Response
{
  "data": {
    "scope": "hr",
    "chips": [
      {
        "count": 14,
        "more": false
      },
      {
        "count": 3,
        "more": false
      }
    ],
    "total": 2,
    "broad": false,
    "order": "levels_then_name",
    "people": [
      {
        "person": {
          "id": "p1",
          "name": "Rita Silva",
          "title": "Accounts assistant",
          "unit": "Finance",
          "location": "Porto"
        },
        "months_in_job": 22,
        "reasons": [
          {
            "kind": "skill",
            "skill_id": "s1",
            "name": "Accounting",
            "level": 3,
            "endorsements": 2
          },
          {
            "kind": "field",
            "code": "0411",
            "status": "in_progress"
          },
          {
            "kind": "open"
          }
        ],
        "open": {
          "kinds": [
            "role"
          ],
          "locations": [
            "Porto"
          ],
          "from": "2027-01-04",
          "note": "After my degree"
        }
      },
      {
        "person": {
          "id": "p2",
          "name": "Zé Costa",
          "title": null,
          "unit": null,
          "location": null
        },
        "months_in_job": null,
        "reasons": [
          {
            "kind": "level",
            "level": 6,
            "status": "done"
          },
          {
            "kind": "course",
            "course_id": "c1",
            "title": "Excel advanced"
          },
          {
            "kind": "credential",
            "name": "CSM"
          },
          {
            "kind": "word",
            "word": "contabilidade"
          }
        ],
        "open": null
      }
    ],
    "next_offset": null,
    "index": {
      "stale": false,
      "rebuilding": false
    },
    "reports_capped": false
  }
}

Export a Find talent search#

POST/v1/talent/search.exportWrite

The people a search finds (as talent_search_people, every page up to 2000) as a CSV: name, work email, title, team, location, months in the job and what matched. Never whether anyone is open to a new role: a search with "open" can't be exported. Owners, admins and HR, in the app, at most 10 a day.

Web app only
Refused for API keys and connected apps. HR downloads a search as a CSV in the app only.
MCP tool
talent_search_export 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

  • chipsobject[]required

    1–8 items.

    16 fields (one of several shapes)

    Option 1

    • kind"skill"required
    • skill_idstringrequired

      1–200 characters.

    • min_levelinteger

      At least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.

      From 1 to 4. Default 1.

    Option 2

    • kind"field"required
    • codestringrequired

      ISCED-F 2013 field: broad (2 digits, e.g. 04 Business, administration and law) or narrow (4, e.g. 0411 Accounting and taxation).

      Pattern ^\d{2}(\d{2})?$.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 3

    • kind"level"required
    • min_levelintegerrequired

      ISCED 2011 level at least: 3 upper secondary … 6 bachelor's, 7 master's, 8 doctoral.

      From 1 to 8.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 4

    • kind"course"required
    • course_idstringrequired

      A training course id (talent_search_vocab).

      1–200 characters.

    Option 5

    • kind"credential"required
    • keystringrequired

      A certificate name key from talent_search_vocab.

      1–120 characters.

    Option 6

    • kind"word"required
    • wordstringrequired

      One word in a qualification, certificate or earlier role title.

      2–40 characters.

    Option 7

    • kind"open"required

      Open to a new role: owners, admins and HR only, in the app; never shows people in your own manager chain.

  • filtersobject
    5 fields
    • location_idsstring[]

      1–200 characters. Up to 20 items.

    • unit_idsstring[]

      Teams, with the teams under them.

      1–200 characters. Up to 20 items.

    • title_idsstring[]

      1–200 characters. Up to 20 items.

    • legal_entity_idsstring[]

      1–200 characters. Up to 20 items.

    • min_months_in_jobinteger

      At least this many months in their current title.

      From 0 to 600.

Returns

  • fileobjectrequired
    5 fields
    • namestringrequired
    • content_typestringrequired
    • encoding"utf8"required
    • contentstringrequired
    • rowsintegerrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/search.export \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "chips": [
    {
      "kind": "skill",
      "skill_id": "s1",
      "min_level": 2
    }
  ],
  "filters": {
    "location_ids": [
      "l1"
    ]
  }
}'
Response
{
  "data": {
    "file": {
      "name": "find-talent-2026-11-21.csv",
      "content_type": "text/csv; charset=utf-8",
      "encoding": "utf8",
      "content": "Name\r\n",
      "rows": 1
    }
  }
}

Rebuild the talent search index#

POST/v1/talent/search.rebuildWrite

Rebuilds the Find talent index from people's profiles, skills and courses, 200 people a call in id order: call again until done is true (Settings shows the progress; position of total). restart true starts over. Idempotent; only what changed is written. The nightly talent sweep finishes a rebuild left halfway. Owners, admins and HR.

Who can call it
Manage key owner admin hr
MCP tool
talent_search_rebuild on HR Assistant
Preview
?dry_run=true runs every check and saves nothing
Retries
An Idempotency-Key replays the first result

Input

  • restartboolean

Returns

  • processedintegerrequired
  • updatedintegerrequired
  • removedintegerrequired
  • donebooleanrequired
  • positionintegerrequired
  • totalintegerrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/search.rebuild \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"restart":true}'
Response
{
  "data": {
    "processed": 200,
    "updated": 180,
    "removed": 2,
    "done": false,
    "position": 200,
    "total": 1200
  }
}

Find colleagues who know something#

POST/v1/talent/search.colleaguesRead

Ask HR's people finder (My workspace): colleagues who list a skill, study, course or certificate matching the text (e.g. "accounting"), optionally in a location (its name, e.g. "Porto"). Only profiles people chose to show to colleagues, never whether anyone wants to move, at most 10, each with name, title, team, location, what matched and a link to their profile. A directory lookup: no ranking beyond the levels, no judgement of anyone. Off unless Find talent is on.

Who can call it
Me key owner admin hr member
MCP tool
talent_search_colleagues on My Workplace
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • textstringrequired

    What they know: a skill, field of study, course or certificate.

    2–80 characters.

  • locationstring

    A location name, e.g. "Porto".

    Up to 80 characters.

Returns

  • matchedstring[]required

    What the text was read as (a skill, course, certificate or word).

  • locationstring | nullrequired

    The location matched, or null.

  • totalintegerrequired
  • peopleobject[]required
    6 fields
    • namestringrequired
    • titlestring | nullrequired
    • unitstring | nullrequired
    • locationstring | nullrequired
    • matchedstring[]required
    • pathstringrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/search.colleagues \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"accounting","location":"Porto"}'
Response
{
  "data": {
    "matched": [
      "Accounting"
    ],
    "location": "Porto",
    "total": 1,
    "people": [
      {
        "name": "Rita Silva",
        "title": "Accounts assistant",
        "unit": "Finance",
        "location": "Porto",
        "matched": [
          "Accounting (level 3)"
        ],
        "path": "/people/p1#talent-profile"
      }
    ]
  }
}

Internal candidates for a job#

POST/v1/talent/match.for_jobRead

"Look inside first" (spec 2026-11-21-internal-talent T7): the people working here who meet a job's criteria, before it goes outside. must (all of them; left out: the job's title's required skills at their levels), nice (counted), open (only people who told HR they are open to a new role; never people in your manager chain) and same_location (the job's location). Each person comes with the reasons: each must-have with what matched, who set it and when ("Accounting: Advanced, manager, 2026-09"; "Accounting and taxation, in progress, ends 2027"), each nice-to-have met or not (never hidden), whether the company's internal-jobs rules let them apply yet (they stay listed), and whether HR invited them (hiring_internal_invite; never shown for people in your own manager chain). The order is plain: every must-have met, then most nice-to-haves, then the sum of levels, then name — no score, no band, and no AI: it filters what people, their managers and HR recorded, and people decide. 50 a page; up to 2000 people read. Owners, admins and HR in the app only: refused over an API key or AI app, and for the job's hiring manager unless they are HR.

Web app only
Refused for API keys and connected apps. Internal candidates for a job are for HR in the app only (Hiring → the job → Inside).
MCP tool
talent_match_for_job on HR Assistant
Method
POST with a JSON body, or GET with the input as query parameters

Input

  • job_idstringrequired

    1–200 characters.

  • mustobject[]

    Must have (all of them). Left out: the job's title's required skills at their levels.

    Up to 8 items.

    16 fields (one of several shapes)

    Option 1

    • kind"skill"required
    • skill_idstringrequired

      1–200 characters.

    • min_levelinteger

      At least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.

      From 1 to 4. Default 1.

    Option 2

    • kind"field"required
    • codestringrequired

      ISCED-F 2013 field: broad (2 digits, e.g. 04 Business, administration and law) or narrow (4, e.g. 0411 Accounting and taxation).

      Pattern ^\d{2}(\d{2})?$.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 3

    • kind"level"required
    • min_levelintegerrequired

      ISCED 2011 level at least: 3 upper secondary … 6 bachelor's, 7 master's, 8 doctoral.

      From 1 to 8.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 4

    • kind"course"required
    • course_idstringrequired

      A training course id (talent_search_vocab).

      1–200 characters.

    Option 5

    • kind"credential"required
    • keystringrequired

      A certificate name key from talent_search_vocab.

      1–120 characters.

    Option 6

    • kind"word"required
    • wordstringrequired

      One word in a qualification, certificate or earlier role title.

      2–40 characters.

    Option 7

    • kind"open"required

      Open to a new role: owners, admins and HR only, in the app; never shows people in your own manager chain.

  • niceobject[]

    Nice to have (counted, never required).

    Up to 8 items.

    16 fields (one of several shapes)

    Option 1

    • kind"skill"required
    • skill_idstringrequired

      1–200 characters.

    • min_levelinteger

      At least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.

      From 1 to 4. Default 1.

    Option 2

    • kind"field"required
    • codestringrequired

      ISCED-F 2013 field: broad (2 digits, e.g. 04 Business, administration and law) or narrow (4, e.g. 0411 Accounting and taxation).

      Pattern ^\d{2}(\d{2})?$.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 3

    • kind"level"required
    • min_levelintegerrequired

      ISCED 2011 level at least: 3 upper secondary … 6 bachelor's, 7 master's, 8 doctoral.

      From 1 to 8.

    • status"done" | "in_progress" | "any"

      Default "any".

    Option 4

    • kind"course"required
    • course_idstringrequired

      A training course id (talent_search_vocab).

      1–200 characters.

    Option 5

    • kind"credential"required
    • keystringrequired

      A certificate name key from talent_search_vocab.

      1–120 characters.

    Option 6

    • kind"word"required
    • wordstringrequired

      One word in a qualification, certificate or earlier role title.

      2–40 characters.

    Option 7

    • kind"open"required

      Open to a new role: owners, admins and HR only, in the app; never shows people in your own manager chain.

  • openboolean

    Only people who told HR they are open to a new role (never people in your own manager chain).

  • same_locationboolean

    Only people at the job's location.

  • offsetinteger

    From 0 to 2000. Default 0.

Returns

10 fields
  • state"ok" | "needs_criteria" | "search_off" | "off"required

    ok; needs_criteria: no must-have (the title lists no required skills: add one); search_off: Find talent is off; off: "Look inside first" is off in Settings → Talent.

  • jobobjectrequired
    7 fields
    • idstringrequired
    • titlestringrequired
    • status"draft" | "open" | "paused" | "closed"required
    • locationstring | nullrequired
    • title_idstring | nullrequired
    • can_invitebooleanrequired

      Invitations need an open job and internal jobs on.

    • invite_blocked"draft" | "not_open" | "internal_off"required
  • criteriaobjectrequired
    3 fields
    • mustobject[]required
      2 fields
      • chipobjectrequired

        The criterion as a chip (talent_search_people).

      • labelstringrequired
    • niceobject[]required
      2 fields
      • chipobjectrequired

        The criterion as a chip (talent_search_people).

      • labelstringrequired
    • from_titlebooleanrequired

      The must-haves are the title's required skills (nothing was given).

  • countsobject[]required

    Per must-have: how many people meet it alone.

    2 fields
    • countintegerrequired
    • morebooleanrequired
  • totalintegerrequired
  • broadbooleanrequired
  • order"must_then_nice_then_levels_then_name"required

    Everyone meets every must-have; then most nice-to-haves met, then the sum of the skill levels over the criteria, then name. No score.

  • peopleobject[]required
    9 fields
    • personobjectrequired
      5 fields
      • idstringrequired
      • namestringrequired
      • titlestring | nullrequired
      • unitstring | nullrequired
      • locationstring | nullrequired
    • months_in_jobinteger | nullrequired
    • openobject | nullrequired

      Open to a new role, as the person told HR: owners, admins and HR in the app only, never for people in your manager chain; null otherwise.

      4 fields
      • kindsstring[]required
      • locationsstring[]required
      • fromstring | nullrequired
      • notestringrequired
    • mustobject[]required

      Each must-have, with what matched, who set it and when.

      26 fields (one of several shapes)

      Option 1

      • kind"skill"required
      • skill_idstringrequired
      • namestringrequired
      • levelintegerrequired
      • endorsementsintegerrequired
      • source"manager" | "training" | "inferred" | "self"required

        Who set the level that counts: manager (their manager or HR), training (a course), inferred (an accepted suggestion), self.

      • atstring | nullrequired

        YYYY-MM it was set.

      Option 2

      • kind"field"required
      • codestringrequired
      • status"done" | "in_progress" | "paused"required
      • qualificationstring | nullrequired

        The qualification that matched.

      • end_yearinteger | nullrequired

      Option 3

      • kind"level"required
      • levelintegerrequired
      • status"done" | "in_progress" | "paused"required
      • qualificationstring | nullrequired

        The qualification that matched.

      • end_yearinteger | nullrequired

      Option 4

      • kind"course"required
      • course_idstringrequired
      • titlestringrequired
      • yearinteger | nullrequired

      Option 5

      • kind"credential"required
      • namestringrequired

      Option 6

      • kind"word"required
      • wordstringrequired

      Option 7

      • kind"open"required
    • niceobject[]required

      Each nice-to-have in order: what matched, or null when not met (never hidden).

      26 fields (one of several shapes)

      Option 1

      • kind"skill"required
      • skill_idstringrequired
      • namestringrequired
      • levelintegerrequired
      • endorsementsintegerrequired
      • source"manager" | "training" | "inferred" | "self"required

        Who set the level that counts: manager (their manager or HR), training (a course), inferred (an accepted suggestion), self.

      • atstring | nullrequired

        YYYY-MM it was set.

      Option 2

      • kind"field"required
      • codestringrequired
      • status"done" | "in_progress" | "paused"required
      • qualificationstring | nullrequired

        The qualification that matched.

      • end_yearinteger | nullrequired

      Option 3

      • kind"level"required
      • levelintegerrequired
      • status"done" | "in_progress" | "paused"required
      • qualificationstring | nullrequired

        The qualification that matched.

      • end_yearinteger | nullrequired

      Option 4

      • kind"course"required
      • course_idstringrequired
      • titlestringrequired
      • yearinteger | nullrequired

      Option 5

      • kind"credential"required
      • namestringrequired

      Option 6

      • kind"word"required
      • wordstringrequired

      Option 7

      • kind"open"required
    • eligibleobject | nullrequired

      Not eligible yet under the company's internal-jobs rules (they stay in the list).

      3 fields
      • rule"min_months" | "probation"required
      • untilstringrequired
      • monthsinteger
    • invited_atstring | nullrequired

      When HR invited them to apply (never for people in your own manager chain).

    • appliedbooleanrequired
    • in_your_chainbooleanrequired

      They report to you: someone else in HR invites them.

  • next_offsetinteger | nullrequired
  • indexobject | nullrequired
    2 fields
    • stalebooleanrequired
    • rebuildingbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/match.for_job \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "job_id": "j1",
  "must": [
    {
      "kind": "skill",
      "skill_id": "s1",
      "min_level": 3
    }
  ],
  "nice": [
    {
      "kind": "field",
      "code": "0411",
      "status": "any"
    },
    {
      "kind": "course",
      "course_id": "c1"
    }
  ],
  "open": true,
  "same_location": true,
  "offset": 50
}'
Response
{
  "data": {
    "state": "ok",
    "job": {
      "id": "j1",
      "title": "Accountant",
      "status": "open",
      "location": "Porto",
      "title_id": "t1",
      "can_invite": true,
      "invite_blocked": null
    },
    "criteria": {
      "must": [
        {
          "chip": {
            "kind": "skill",
            "skill_id": "s1",
            "min_level": 3
          },
          "label": "Accounting"
        }
      ],
      "nice": [
        {
          "chip": {
            "kind": "field",
            "code": "0411",
            "status": "any"
          },
          "label": "0411"
        },
        {
          "chip": {
            "kind": "skill",
            "skill_id": "s2",
            "min_level": 2
          },
          "label": "Excel"
        }
      ],
      "from_title": false
    },
    "counts": [
      {
        "count": 14,
        "more": false
      }
    ],
    "total": 2,
    "broad": false,
    "order": "must_then_nice_then_levels_then_name",
    "people": [
      {
        "person": {
          "id": "p1",
          "name": "Rita Silva",
          "title": "Accounts assistant",
          "unit": "Finance",
          "location": "Porto"
        },
        "months_in_job": 22,
        "open": {
          "kinds": [
            "role"
          ],
          "locations": [
            "Lisbon"
          ],
          "from": null,
          "note": ""
        },
        "must": [
          {
            "kind": "skill",
            "skill_id": "s1",
            "name": "Accounting",
            "level": 3,
            "endorsements": 3,
            "source": "manager",
            "at": "2026-09"
          }
        ],
        "nice": [
          {
            "kind": "field",
            "code": "0411",
            "status": "in_progress",
            "qualification": "Licenciatura em Contabilidade",
            "end_year": 2027
          },
          null
        ],
        "eligible": null,
        "invited_at": "2026-11-16T10:00:00.000Z",
        "applied": false,
        "in_your_chain": false
      },
      {
        "person": {
          "id": "p2",
          "name": "Zé Costa",
          "title": "Customer care agent",
          "unit": "Care",
          "location": "Braga"
        },
        "months_in_job": 4,
        "open": null,
        "must": [
          {
            "kind": "skill",
            "skill_id": "s1",
            "name": "Accounting",
            "level": 4,
            "endorsements": 0,
            "source": "self",
            "at": "2026-10"
          }
        ],
        "nice": [
          null,
          {
            "kind": "course",
            "course_id": "c1",
            "title": "Excel advanced",
            "year": 2025
          }
        ],
        "eligible": {
          "rule": "min_months",
          "until": "2027-03-01",
          "months": 6
        },
        "invited_at": null,
        "applied": false,
        "in_your_chain": false
      }
    ],
    "next_offset": null,
    "index": {
      "stale": false,
      "rebuilding": false
    }
  }
}

Confirm a colleague's skill#

POST/v1/talent/endorsements.giveWrite

"I've worked with this": confirms a skill on a colleague's talent profile (person_id, skill_id from talent_profile_get, optional note ≤ 140 characters). You need to be able to see their profile (it is shown to colleagues, or you are their manager or HR), the skill must count on it, and they must have endorsements on. Once per skill and colleague (again: the note is replaced), never on yourself, at most 30 a day and 5 a day to the same person. It never changes the skill's level. The person sees who confirmed it (in-app notice, no email) and can hide it. Signed in to Bizisy only.

Web app only
Refused for API keys and connected apps. People confirm a colleague's skill themselves, in the app.
MCP tool
talent_endorsements_give on My Workplace, 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.

  • skill_idstringrequired

    1–200 characters.

  • notestring | null

    Up to 140 characters.

Returns

  • person_idstringrequired
  • skill_idstringrequired
  • giventruerequired
  • againbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/endorsements.give \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"person_id":"p4","skill_id":"s1","note":"Closed the month with me"}'
Response
{
  "data": {
    "person_id": "p1",
    "skill_id": "s1",
    "given": true,
    "again": false
  }
}

Withdraw a skill confirmation#

POST/v1/talent/endorsements.withdrawWrite

Takes back your "I've worked with this" on a colleague's skill (person_id, skill_id). withdrawn false when you had none. Signed in to Bizisy only.

Web app only
Refused for API keys and connected apps. Withdrawn in the app only.
MCP tool
talent_endorsements_withdraw on My Workplace, 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.

  • skill_idstringrequired

    1–200 characters.

Returns

  • person_idstringrequired
  • skill_idstringrequired
  • withdrawnbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/endorsements.withdraw \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"person_id":"p1","skill_id":"s1"}'
Response
{
  "data": {
    "person_id": "p1",
    "skill_id": "s1",
    "withdrawn": true
  }
}

Hide or show a confirmation of my skill#

POST/v1/talent/endorsements.hideWrite

Hides (hidden true) or shows again (false) one colleague's confirmation of your skill (skill_id, by: their person id from talent_profile_get → skills → endorsements.by). Hidden ones leave the count and search. To turn all of them off, use talent_profile_update with endorsements false. Your own profile only, signed in to Bizisy.

Web app only
Refused for API keys and connected apps. The person hides a confirmation in the app only.
MCP tool
talent_endorsements_hide 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

  • skill_idstringrequired

    1–200 characters.

  • bystringrequired

    1–200 characters.

  • hiddenboolean

    Default true.

Returns

  • skill_idstringrequired
  • bystringrequired
  • hiddenbooleanrequired

Errors

validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal

curl
curl https://api.bizisy.com/v1/talent/endorsements.hide \
  -H "Authorization: Bearer $BIZISY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"skill_id":"s1","by":"p7","hidden":false}'
Response
{
  "data": {
    "skill_id": "s1",
    "by": "p7",
    "hidden": false
  }
}

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

Developer docs