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_vocabon My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
qstringrequired1–80 characters.
Returns
skillsobject[]required3 fields
idstringrequirednamestringrequiredcategorystringrequired
coursesobject[]required2 fields
idstringrequiredtitlestringrequired
credentialsobject[]required2 fields
keystringrequiredlabelstringrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/talent/search.vocab \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"acc"}'const res = await fetch('https://api.bizisy.com/v1/talent/search.vocab', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"q": "acc"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/search.vocab",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"q": "acc",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_peopleon My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
chipsobject[]required1–8 items.
16 fields (one of several shapes)
Option 1
kind"skill"requiredskill_idstringrequired1–200 characters.
min_levelintegerAt least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.
From 1 to 4. Default
1.
Option 2
kind"field"requiredcodestringrequiredISCED-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"requiredmin_levelintegerrequiredISCED 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"requiredcourse_idstringrequiredA training course id (talent_search_vocab).
1–200 characters.
Option 5
kind"credential"requiredkeystringrequiredA certificate name key from talent_search_vocab.
1–120 characters.
Option 6
kind"word"requiredwordstringrequiredOne word in a qualification, certificate or earlier role title.
2–40 characters.
Option 7
kind"open"requiredOpen to a new role: owners, admins and HR only, in the app; never shows people in your own manager chain.
filtersobject5 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_jobintegerAt 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).
offsetintegerFrom 0 to 2000. Default
0.
Returns
9 fields
scope"hr" | "manager" | "colleague"requiredhr: everyone working here; manager: profiles shown to colleagues plus your reports; colleague: profiles shown to colleagues.
chipsobject[]requiredPer 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
countintegerrequiredmorebooleanrequired
totalintegerrequiredPeople who meet every chip and filter (of the first 2,000 read when broad).
broadbooleanrequiredThe narrowest chip matched more than 2000 people: only the first 2000 were checked. Add a chip to narrow it.
order"levels_then_name"requiredThe sum of the levels of the skill chips (highest first), then name. No score.
peopleobject[]required4 fields
personobjectrequired5 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredunitstring | nullrequiredlocationstring | nullrequired
months_in_jobinteger | nullrequiredreasonsobject[]requiredEach chip this person meets, with what matched (the order of the chips).
19 fields (one of several shapes)
Option 1
kind"skill"requiredskill_idstringrequirednamestringrequiredlevelintegerrequiredendorsementsintegerrequiredColleagues who confirmed it ("I've worked with this").
Option 2
kind"field"requiredcodestringrequiredstatus"done" | "in_progress" | "paused"required
Option 3
kind"level"requiredlevelintegerrequiredstatus"done" | "in_progress" | "paused"required
Option 4
kind"course"requiredcourse_idstringrequiredtitlestringrequired
Option 5
kind"credential"requirednamestringrequired
Option 6
kind"word"requiredwordstringrequired
Option 7
kind"open"required
openobject | nullrequiredOpen 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[]requiredlocationsstring[]requiredfromstring | nullrequirednotestringrequired
next_offsetinteger | nullrequiredindexobject | nullrequiredHR only: the index is behind (rebuild in Settings → Talent → Talent profiles).
2 fields
stalebooleanrequiredrebuildingbooleanrequired
reports_cappedbooleanrequiredA 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 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
}'const res = await fetch('https://api.bizisy.com/v1/talent/search.people', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"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
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/search.people",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"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,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_exporton HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
chipsobject[]required1–8 items.
16 fields (one of several shapes)
Option 1
kind"skill"requiredskill_idstringrequired1–200 characters.
min_levelintegerAt least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.
From 1 to 4. Default
1.
Option 2
kind"field"requiredcodestringrequiredISCED-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"requiredmin_levelintegerrequiredISCED 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"requiredcourse_idstringrequiredA training course id (talent_search_vocab).
1–200 characters.
Option 5
kind"credential"requiredkeystringrequiredA certificate name key from talent_search_vocab.
1–120 characters.
Option 6
kind"word"requiredwordstringrequiredOne word in a qualification, certificate or earlier role title.
2–40 characters.
Option 7
kind"open"requiredOpen to a new role: owners, admins and HR only, in the app; never shows people in your own manager chain.
filtersobject5 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_jobintegerAt least this many months in their current title.
From 0 to 600.
Returns
fileobjectrequired5 fields
namestringrequiredcontent_typestringrequiredencoding"utf8"requiredcontentstringrequiredrowsintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
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"
]
}
}'const res = await fetch('https://api.bizisy.com/v1/talent/search.export', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"chips": [
{
"kind": "skill",
"skill_id": "s1",
"min_level": 2
}
],
"filters": {
"location_ids": [
"l1"
]
}
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/search.export",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"chips": [
{
"kind": "skill",
"skill_id": "s1",
"min_level": 2,
},
],
"filters": {
"location_ids": [
"l1",
],
},
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_rebuildon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
restartboolean
Returns
processedintegerrequiredupdatedintegerrequiredremovedintegerrequireddonebooleanrequiredpositionintegerrequiredtotalintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
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}'const res = await fetch('https://api.bizisy.com/v1/talent/search.rebuild', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"restart": true
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/search.rebuild",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"restart": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_colleagueson My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
textstringrequiredWhat they know: a skill, field of study, course or certificate.
2–80 characters.
locationstringA location name, e.g. "Porto".
Up to 80 characters.
Returns
matchedstring[]requiredWhat the text was read as (a skill, course, certificate or word).
locationstring | nullrequiredThe location matched, or null.
totalintegerrequiredpeopleobject[]required6 fields
namestringrequiredtitlestring | nullrequiredunitstring | nullrequiredlocationstring | nullrequiredmatchedstring[]requiredpathstringrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
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"}'const res = await fetch('https://api.bizisy.com/v1/talent/search.colleagues', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"text": "accounting",
"location": "Porto"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/search.colleagues",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"text": "accounting",
"location": "Porto",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_jobon HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
job_idstringrequired1–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"requiredskill_idstringrequired1–200 characters.
min_levelintegerAt least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.
From 1 to 4. Default
1.
Option 2
kind"field"requiredcodestringrequiredISCED-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"requiredmin_levelintegerrequiredISCED 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"requiredcourse_idstringrequiredA training course id (talent_search_vocab).
1–200 characters.
Option 5
kind"credential"requiredkeystringrequiredA certificate name key from talent_search_vocab.
1–120 characters.
Option 6
kind"word"requiredwordstringrequiredOne word in a qualification, certificate or earlier role title.
2–40 characters.
Option 7
kind"open"requiredOpen 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"requiredskill_idstringrequired1–200 characters.
min_levelintegerAt least this level: 1 Foundation, 2 Working, 3 Advanced, 4 Expert.
From 1 to 4. Default
1.
Option 2
kind"field"requiredcodestringrequiredISCED-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"requiredmin_levelintegerrequiredISCED 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"requiredcourse_idstringrequiredA training course id (talent_search_vocab).
1–200 characters.
Option 5
kind"credential"requiredkeystringrequiredA certificate name key from talent_search_vocab.
1–120 characters.
Option 6
kind"word"requiredwordstringrequiredOne word in a qualification, certificate or earlier role title.
2–40 characters.
Option 7
kind"open"requiredOpen to a new role: owners, admins and HR only, in the app; never shows people in your own manager chain.
openbooleanOnly people who told HR they are open to a new role (never people in your own manager chain).
same_locationbooleanOnly people at the job's location.
offsetintegerFrom 0 to 2000. Default
0.
Returns
10 fields
state"ok" | "needs_criteria" | "search_off" | "off"requiredok; 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.
jobobjectrequired7 fields
idstringrequiredtitlestringrequiredstatus"draft" | "open" | "paused" | "closed"requiredlocationstring | nullrequiredtitle_idstring | nullrequiredcan_invitebooleanrequiredInvitations need an open job and internal jobs on.
invite_blocked"draft" | "not_open" | "internal_off"required
criteriaobjectrequired3 fields
mustobject[]required2 fields
chipobjectrequiredThe criterion as a chip (talent_search_people).
labelstringrequired
niceobject[]required2 fields
chipobjectrequiredThe criterion as a chip (talent_search_people).
labelstringrequired
from_titlebooleanrequiredThe must-haves are the title's required skills (nothing was given).
countsobject[]requiredPer must-have: how many people meet it alone.
2 fields
countintegerrequiredmorebooleanrequired
totalintegerrequiredbroadbooleanrequiredorder"must_then_nice_then_levels_then_name"requiredEveryone 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[]required9 fields
personobjectrequired5 fields
idstringrequirednamestringrequiredtitlestring | nullrequiredunitstring | nullrequiredlocationstring | nullrequired
months_in_jobinteger | nullrequiredopenobject | nullrequiredOpen 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[]requiredlocationsstring[]requiredfromstring | nullrequirednotestringrequired
mustobject[]requiredEach must-have, with what matched, who set it and when.
26 fields (one of several shapes)
Option 1
kind"skill"requiredskill_idstringrequirednamestringrequiredlevelintegerrequiredendorsementsintegerrequiredsource"manager" | "training" | "inferred" | "self"requiredWho set the level that counts: manager (their manager or HR), training (a course), inferred (an accepted suggestion), self.
atstring | nullrequiredYYYY-MM it was set.
Option 2
kind"field"requiredcodestringrequiredstatus"done" | "in_progress" | "paused"requiredqualificationstring | nullrequiredThe qualification that matched.
end_yearinteger | nullrequired
Option 3
kind"level"requiredlevelintegerrequiredstatus"done" | "in_progress" | "paused"requiredqualificationstring | nullrequiredThe qualification that matched.
end_yearinteger | nullrequired
Option 4
kind"course"requiredcourse_idstringrequiredtitlestringrequiredyearinteger | nullrequired
Option 5
kind"credential"requirednamestringrequired
Option 6
kind"word"requiredwordstringrequired
Option 7
kind"open"required
niceobject[]requiredEach nice-to-have in order: what matched, or null when not met (never hidden).
26 fields (one of several shapes)
Option 1
kind"skill"requiredskill_idstringrequirednamestringrequiredlevelintegerrequiredendorsementsintegerrequiredsource"manager" | "training" | "inferred" | "self"requiredWho set the level that counts: manager (their manager or HR), training (a course), inferred (an accepted suggestion), self.
atstring | nullrequiredYYYY-MM it was set.
Option 2
kind"field"requiredcodestringrequiredstatus"done" | "in_progress" | "paused"requiredqualificationstring | nullrequiredThe qualification that matched.
end_yearinteger | nullrequired
Option 3
kind"level"requiredlevelintegerrequiredstatus"done" | "in_progress" | "paused"requiredqualificationstring | nullrequiredThe qualification that matched.
end_yearinteger | nullrequired
Option 4
kind"course"requiredcourse_idstringrequiredtitlestringrequiredyearinteger | nullrequired
Option 5
kind"credential"requirednamestringrequired
Option 6
kind"word"requiredwordstringrequired
Option 7
kind"open"required
eligibleobject | nullrequiredNot eligible yet under the company's internal-jobs rules (they stay in the list).
3 fields
rule"min_months" | "probation"requireduntilstringrequiredmonthsinteger
invited_atstring | nullrequiredWhen HR invited them to apply (never for people in your own manager chain).
appliedbooleanrequiredin_your_chainbooleanrequiredThey report to you: someone else in HR invites them.
next_offsetinteger | nullrequiredindexobject | nullrequired2 fields
stalebooleanrequiredrebuildingbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
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
}'const res = await fetch('https://api.bizisy.com/v1/talent/match.for_job', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"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
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/match.for_job",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"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,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_giveon My Workplace, HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
person_idstringrequired1–200 characters.
skill_idstringrequired1–200 characters.
notestring | nullUp to 140 characters.
Returns
person_idstringrequiredskill_idstringrequiredgiventruerequiredagainbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
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"}'const res = await fetch('https://api.bizisy.com/v1/talent/endorsements.give', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"person_id": "p4",
"skill_id": "s1",
"note": "Closed the month with me"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/endorsements.give",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"person_id": "p4",
"skill_id": "s1",
"note": "Closed the month with me",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_withdrawon My Workplace, HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
person_idstringrequired1–200 characters.
skill_idstringrequired1–200 characters.
Returns
person_idstringrequiredskill_idstringrequiredwithdrawnbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
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"}'const res = await fetch('https://api.bizisy.com/v1/talent/endorsements.withdraw', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"person_id": "p1",
"skill_id": "s1"
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/endorsements.withdraw",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"person_id": "p1",
"skill_id": "s1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"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_hideon My Workplace- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key prevents a second run, but the result is never stored (it holds a secret or personal data): a retry gets a 409 that points to Activity
Input
skill_idstringrequired1–200 characters.
bystringrequired1–200 characters.
hiddenbooleanDefault
true.
Returns
skill_idstringrequiredbystringrequiredhiddenbooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
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}'const res = await fetch('https://api.bizisy.com/v1/talent/endorsements.hide', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"skill_id": "s1",
"by": "p7",
"hidden": false
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/talent/endorsements.hide",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"skill_id": "s1",
"by": "p7",
"hidden": False,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"skill_id": "s1",
"by": "p7",
"hidden": false
}
}Something missing or wrong on this page? Write to hello@bizisy.com.