API reference
Equipment register
Laptops, phones, badges and cars: list, add, hand over, take back, import, retire, and the report by team; devices synced from Jamf Pro, Microsoft Intune, Kandji and Workwize are flagged for review.
9 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
List equipment#
POST/v1/assets/listRead
Lists equipment in the register (laptops, phones, monitors, badges, cars…), sorted by name. Owners, admins and HR see every item with its value, purchase date, tag, notes and, for devices synced from Jamf Pro, Microsoft Intune, Kandji or Workwize, the tool's user and review flag. Anyone else sees only the equipment held by them or by people who report to them (no value, notes or tool details). Filters: q (words in the name, model, serial or tag), type, status, person_id (what one person holds), team_id (held by people in a team today), source (manual or a tool id), review (only synced devices to look at: unmatched user, mismatch, missing from the tool).
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
assets_liston HR Assistant, My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
qstringUp to 100 characters.
typestring (enum)One of:
laptop,desktop,phone,tablet,monitor,badge,car,other.status"in_stock" | "assigned" | "in_repair" | "retired"person_idstring1–100 characters.
team_idstring1–100 characters.
sourcestringmanual, or jamf, intune, kandji, workwize.
Up to 40 characters.
reviewbooleanlimitintegerDefault 1000.
From 1 to 5000.
Returns
itemsobject[]required19 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequired
totalintegerrequiredMatching items before the limit.
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/list \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"q": "macbook",
"type": "laptop",
"status": "assigned",
"person_id": "p1",
"team_id": "u1",
"source": "jamf",
"review": true,
"limit": 50
}'const res = await fetch('https://api.bizisy.com/v1/assets/list', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"q": "macbook",
"type": "laptop",
"status": "assigned",
"person_id": "p1",
"team_id": "u1",
"source": "jamf",
"review": true,
"limit": 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/assets/list",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"q": "macbook",
"type": "laptop",
"status": "assigned",
"person_id": "p1",
"team_id": "u1",
"source": "jamf",
"review": True,
"limit": 50,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "assigned",
"holder": {
"id": "p1",
"name": "Ana Ferreira"
},
"since": "2026-01-05",
"confirmed_at": "2026-01-05T10:00:00.000Z",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": "Bought with the Lisbon budget",
"source": {
"connector": "jamf",
"platform": "macOS",
"os_version": "15.1",
"managed": true,
"last_seen_at": "2026-10-04T08:00:00.000Z",
"console_url": "https://acme.jamfcloud.com/computers.html?id=7",
"user": {
"email": "ana@acme.test",
"name": "Ana Ferreira"
},
"match": "matched",
"missing": false
},
"review": null,
"access": "full",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z"
}
],
"total": 1
}
}Get equipment#
POST/v1/assets/getRead
One item and, for owners, admins and HR, its dated history (who had it, from, to, and how it came back). The holder and their managers see the item without value, notes, tool details or history.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
assets_geton HR Assistant, My Workplace- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
asset_idstringrequired1–100 characters.
Returns
itemobjectrequired19 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequired
historyobject[]required6 fields
idstringrequiredpersonobject | nullrequirednull: the person was erased.
2 fields
idstringrequirednamestringrequired
fromstringrequiredtostring | nullrequiredreturnedobject | nullrequired2 fields
condition"ok" | "damaged" | "lost"requirednotestring | nullrequired
by"hr" | "sync"required
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/get \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"as1"}'const res = await fetch('https://api.bizisy.com/v1/assets/get', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"asset_id": "as1"
}),
});
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/assets/get",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"asset_id": "as1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"item": {
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "assigned",
"holder": {
"id": "p1",
"name": "Ana Ferreira"
},
"since": "2026-01-05",
"confirmed_at": "2026-01-05T10:00:00.000Z",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": "Bought with the Lisbon budget",
"source": {
"connector": "jamf",
"platform": "macOS",
"os_version": "15.1",
"managed": true,
"last_seen_at": "2026-10-04T08:00:00.000Z",
"console_url": "https://acme.jamfcloud.com/computers.html?id=7",
"user": {
"email": "ana@acme.test",
"name": "Ana Ferreira"
},
"match": "matched",
"missing": false
},
"review": null,
"access": "full",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z"
},
"history": [
{
"id": "h1",
"person": {
"id": "p1",
"name": "Ana Ferreira"
},
"from": "2026-01-05",
"to": null,
"returned": null,
"by": "hr"
}
]
}
}Add equipment#
POST/v1/assets/createWrite
Adds an item to the equipment register: type, name, and optionally model, serial (unique in the company), asset_tag, value with currency, purchase_date and notes. status in_stock (default), in_repair or retired; or assign_to {person_id, since} to hand it to someone at once (employed or about to start; since defaults to today, at most 30 days ahead). A company holds up to 5000 items. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
assets_createon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
typestring (enum)requiredlaptop, desktop, phone, tablet, monitor, badge, car or other.
One of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredWhat people call it, e.g. "MacBook Pro 14" or "Office badge".
1–120 characters.
modelstring | nullUp to 120 characters.
serialstring | nullUnique in the company (compared without spaces or dashes, case-insensitive).
Up to 80 characters.
asset_tagstring | nullYour own inventory number or label.
Up to 60 characters.
valuenumber | nullPurchase value, in currency (two decimals). HR only.
From 0 to 10000000.
currencystring | nullISO 4217 code; required with a value.
Pattern
^[A-Za-z]{3}$.purchase_datestring | nullPattern
^\d{4}-\d{2}-\d{2}$.notesstring | nullHR only; never shown to the person or their managers.
Up to 1000 characters.
status"in_stock" | "in_repair" | "retired"assign_toobject2 fields
person_idstringrequired1–100 characters.
sincestringPattern
^\d{4}-\d{2}-\d{2}$.
Returns
19 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/create \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": null,
"assign_to": {
"person_id": "p1",
"since": "2026-01-05"
}
}'const res = await fetch('https://api.bizisy.com/v1/assets/create', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": null,
"assign_to": {
"person_id": "p1",
"since": "2026-01-05"
}
}),
});
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/assets/create",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": None,
"assign_to": {
"person_id": "p1",
"since": "2026-01-05",
},
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "assigned",
"holder": {
"id": "p1",
"name": "Ana Ferreira"
},
"since": "2026-01-05",
"confirmed_at": "2026-01-05T10:00:00.000Z",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": null,
"source": {
"connector": "jamf",
"platform": "macOS",
"os_version": "15.1",
"managed": true,
"last_seen_at": "2026-10-04T08:00:00.000Z",
"console_url": "https://acme.jamfcloud.com/computers.html?id=7",
"user": {
"email": "ana@acme.test",
"name": "Ana Ferreira"
},
"match": "matched",
"missing": false
},
"review": null,
"access": "full",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z"
}
}Change equipment#
POST/v1/assets/updateWrite
Changes an item's details (type, name, model, serial, asset_tag, value, currency, purchase_date, notes; null clears), or its status: in_stock, in_repair or retired (equipment someone holds is returned with assets_return first). keep_holder: true on a synced device flagged mismatch or unmatched keeps Bizisy's holder (or no holder) although the tool names another user; the flag comes back only when the tool's user changes. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
assets_updateon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
typestring (enum)laptop, desktop, phone, tablet, monitor, badge, car or other.
One of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringWhat people call it, e.g. "MacBook Pro 14" or "Office badge".
1–120 characters.
modelstring | nullUp to 120 characters.
serialstring | nullUnique in the company (compared without spaces or dashes, case-insensitive).
Up to 80 characters.
asset_tagstring | nullYour own inventory number or label.
Up to 60 characters.
valuenumber | nullPurchase value, in currency (two decimals). HR only.
From 0 to 10000000.
currencystring | nullISO 4217 code; required with a value.
Pattern
^[A-Za-z]{3}$.purchase_datestring | nullPattern
^\d{4}-\d{2}-\d{2}$.notesstring | nullHR only; never shown to the person or their managers.
Up to 1000 characters.
asset_idstringrequired1–100 characters.
status"in_stock" | "in_repair" | "retired"keep_holdertrue
Returns
19 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/update \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"asset_id":"as1","name":"MacBook Pro 14 (2023)"}'const res = await fetch('https://api.bizisy.com/v1/assets/update', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"asset_id": "as1",
"name": "MacBook Pro 14 (2023)"
}),
});
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/assets/update",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"asset_id": "as1",
"name": "MacBook Pro 14 (2023)",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14 (2023)",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "assigned",
"holder": {
"id": "p1",
"name": "Ana Ferreira"
},
"since": "2026-01-05",
"confirmed_at": "2026-01-05T10:00:00.000Z",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": "Bought with the Lisbon budget",
"source": {
"connector": "jamf",
"platform": "macOS",
"os_version": "15.1",
"managed": true,
"last_seen_at": "2026-10-04T08:00:00.000Z",
"console_url": "https://acme.jamfcloud.com/computers.html?id=7",
"user": {
"email": "ana@acme.test",
"name": "Ana Ferreira"
},
"match": "matched",
"missing": false
},
"review": null,
"access": "full",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z"
}
}Assign equipment#
POST/v1/assets/assignWrite
Hands an item to a person (employed or about to start) on a day (since, default today, at most 30 days ahead). An item someone else holds moves to the new person: the previous holder's history row closes that day. The person sees it in My equipment and confirms they have it. Retired items can't be assigned. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
assets_assignon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
asset_idstringrequired1–100 characters.
person_idstringrequired1–100 characters.
sincestringPattern
^\d{4}-\d{2}-\d{2}$.
Returns
19 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/assign \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"asset_id":"as1","person_id":"p1","since":"2026-10-01"}'const res = await fetch('https://api.bizisy.com/v1/assets/assign', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"asset_id": "as1",
"person_id": "p1",
"since": "2026-10-01"
}),
});
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/assets/assign",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"asset_id": "as1",
"person_id": "p1",
"since": "2026-10-01",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "assigned",
"holder": {
"id": "p1",
"name": "Ana Ferreira"
},
"since": "2026-10-01",
"confirmed_at": "2026-01-05T10:00:00.000Z",
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": "Bought with the Lisbon budget",
"source": {
"connector": "jamf",
"platform": "macOS",
"os_version": "15.1",
"managed": true,
"last_seen_at": "2026-10-04T08:00:00.000Z",
"console_url": "https://acme.jamfcloud.com/computers.html?id=7",
"user": {
"email": "ana@acme.test",
"name": "Ana Ferreira"
},
"match": "matched",
"missing": false
},
"review": null,
"access": "full",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z"
}
}Take equipment back#
POST/v1/assets/returnWrite
Records that the holder gave an item back on a day (on, default today; not before they got it) and its condition: ok (back in stock, default), damaged (in repair) or lost (retired), with an optional note. An open offboarding task "Collect equipment" ticks itself once they hold nothing. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
assets_returnon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
asset_idstringrequired1–100 characters.
onstringPattern
^\d{4}-\d{2}-\d{2}$.condition"ok" | "damaged" | "lost"notestring | nullUp to 500 characters.
Returns
20 fields
idstringrequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.namestringrequiredmodelstring | nullrequiredserialstring | nullrequiredstatus"in_stock" | "assigned" | "in_repair" | "retired"requiredholderobject | nullrequiredWho has it now.
2 fields
idstringrequirednamestringrequired
sincestring | nullrequiredThe day they got it.
confirmed_atstring | nullrequiredWhen the holder confirmed they have it; null while waiting.
asset_tagstring | nullrequiredvaluenumber | nullrequiredcurrencystring | nullrequiredpurchase_datestring | nullrequirednotesstring | nullrequiredsourceobject | nullrequiredA device read from a device management tool.
9 fields
connectorstringrequiredjamf, intune, kandji or workwize.
platformstring | nullrequiredos_versionstring | nullrequiredmanagedboolean | nullrequiredlast_seen_atstring | nullrequiredLast check-in with the tool.
console_urlstring | nullrequiredThe device in the tool (HR acts there: Bizisy never locks or wipes).
userobject | nullrequiredWho the tool says uses it. HR only (null for others).
2 fields
emailstring | nullrequirednamestring | nullrequired
match"matched" | "unmatched" | "none" | "mismatch"requiredmatched (a person in Bizisy), unmatched (no one has that email), none (no user in the tool), mismatch (assigned in Bizisy to someone else). HR only.
missingbooleanrequiredNot in the tool any more since the last sync.
review"unmatched" | "mismatch" | "missing"requiredWhat HR should look at for a synced device (HR only).
access"full" | "holder"requiredholder: the person or their manager: no value, purchase date, tag, notes or tool details.
created_atstringrequiredupdated_atstringrequiredreturned_byobjectrequired1 field
idstringrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/return \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"asset_id": "as1",
"on": "2026-10-04",
"condition": "damaged",
"note": "Cracked screen"
}'const res = await fetch('https://api.bizisy.com/v1/assets/return', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"asset_id": "as1",
"on": "2026-10-04",
"condition": "damaged",
"note": "Cracked screen"
}),
});
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/assets/return",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"asset_id": "as1",
"on": "2026-10-04",
"condition": "damaged",
"note": "Cracked screen",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "as1",
"type": "laptop",
"name": "MacBook Pro 14",
"model": "MacBookPro18,3",
"serial": "C02XY123",
"status": "in_stock",
"holder": null,
"since": null,
"confirmed_at": null,
"asset_tag": "IT-0042",
"value": 2399,
"currency": "EUR",
"purchase_date": "2025-12-20",
"notes": "Bought with the Lisbon budget",
"source": {
"connector": "jamf",
"platform": "macOS",
"os_version": "15.1",
"managed": true,
"last_seen_at": "2026-10-04T08:00:00.000Z",
"console_url": "https://acme.jamfcloud.com/computers.html?id=7",
"user": {
"email": "ana@acme.test",
"name": "Ana Ferreira"
},
"match": "matched",
"missing": false
},
"review": null,
"access": "full",
"created_at": "2026-01-05T10:00:00.000Z",
"updated_at": "2026-10-04T08:00:00.000Z",
"returned_by": {
"id": "p1"
}
}
}Delete equipment#
POST/v1/assets/deleteDestructive
Deletes an item entered by mistake, with its history. Synced devices can't be deleted (the next sync would bring them back): retire them instead. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
assets_deleteon HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
asset_idstringrequired1–100 characters.
Returns
idstringrequireddeletedtruerequiredtypestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.holder_idstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/delete \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"asset_id":"as1"}'const res = await fetch('https://api.bizisy.com/v1/assets/delete', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"asset_id": "as1"
}),
});
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/assets/delete",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"asset_id": "as1",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"id": "as1",
"deleted": true,
"type": "laptop",
"holder_id": null
}
}Import equipment#
POST/v1/assets/importWrite
Adds up to 150 items at once (from a spreadsheet: one row each). Columns: type, name, model, serial, asset_tag, value, currency, purchase_date (YYYY-MM-DD), status, assigned_to (a work email), assigned_since, notes. All or nothing: run it as a dry run first to see each row's outcome; the real run refuses if any row has a problem (a duplicate serial, an unknown type or email, a value without currency, a date in the wrong format). Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
assets_importon 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
rowsobject[]required1–150 items.
12 fields
typestringrequiredlaptop, phone, tablet, monitor, badge, car or other (case-insensitive).
Up to 40 characters.
namestringrequiredUp to 200 characters.
modelstring | nullUp to 200 characters.
serialstring | nullUp to 200 characters.
asset_tagstring | nullUp to 200 characters.
valuenumber | stringA number; a comma as decimal separator is accepted.
currencystring | nullUp to 10 characters.
purchase_datestring | nullUp to 40 characters.
statusstring | nullin_stock (default), in_repair or retired; ignored when assigned_to is set.
Up to 40 characters.
assigned_tostring | nullThe work email of the person who has it.
Up to 320 characters.
assigned_sincestring | nullUp to 40 characters.
notesstring | nullUp to 2000 characters.
Returns
createdintegerrequiredassignedintegerrequiredrowsobject[]required4 fields
rowintegerrequired1 = the first data row.
okbooleanrequiredproblemstring | nullrequiredasset_idstring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found conflict module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/import \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"rows": [
{
"type": "laptop",
"name": "ThinkPad X1",
"serial": "PF-1",
"value": "1299,50",
"currency": "EUR",
"assigned_to": "ana@acme.test",
"assigned_since": "2026-09-01"
}
]
}'const res = await fetch('https://api.bizisy.com/v1/assets/import', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"rows": [
{
"type": "laptop",
"name": "ThinkPad X1",
"serial": "PF-1",
"value": "1299,50",
"currency": "EUR",
"assigned_to": "ana@acme.test",
"assigned_since": "2026-09-01"
}
]
}),
});
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/assets/import",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"rows": [
{
"type": "laptop",
"name": "ThinkPad X1",
"serial": "PF-1",
"value": "1299,50",
"currency": "EUR",
"assigned_to": "ana@acme.test",
"assigned_since": "2026-09-01",
},
],
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"created": 1,
"assigned": 1,
"rows": [
{
"row": 1,
"ok": true,
"problem": null,
"asset_id": "as2"
}
]
}
}Equipment by team#
POST/v1/assets/reportRead
How much equipment the company has and where: totals by status, values summed per currency, and per team (the holder's team today) the people holding equipment, the items and their value, and counts by type. Owners, admins and HR.
- Who can call it
- Manage key owner admin hr
- MCP tool
assets_reporton HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
as_ofstringrequiredtotalsobjectrequired6 fields
itemsintegerrequiredassignedintegerrequiredin_stockintegerrequiredin_repairintegerrequiredretiredintegerrequiredto_reviewintegerrequired
valuesobject[]requiredSums of value per currency (items without a value are not counted).
3 fields
currencystringrequiredtotalnumberrequiredassignednumberrequired
teamsobject[]required5 fields
teamobject | nullrequirednull: people with no team.
2 fields
idstringrequirednamestringrequired
peopleintegerrequiredPeople in the team holding equipment.
itemsintegerrequiredvaluesobject[]required2 fields
currencystringrequiredtotalnumberrequired
by_typeobject[]required2 fields
typestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.countintegerrequired
typesobject[]required3 fields
typestring (enum)requiredOne of:
laptop,desktop,phone,tablet,monitor,badge,car,other.totalintegerrequiredassignedintegerrequired
Errors
validation_failed unauthenticated forbidden not_found module_disabled rate_limited internal
curl https://api.bizisy.com/v1/assets/report \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/assets/report', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
console.log(body.data);import os
import requests
res = requests.post(
"https://api.bizisy.com/v1/assets/report",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"as_of": "2026-10-04",
"totals": {
"items": 3,
"assigned": 2,
"in_stock": 1,
"in_repair": 0,
"retired": 0,
"to_review": 1
},
"values": [
{
"currency": "EUR",
"total": 3200,
"assigned": 2900
}
],
"teams": [
{
"team": {
"id": "u1",
"name": "Engineering"
},
"people": 1,
"items": 2,
"values": [
{
"currency": "EUR",
"total": 2900
}
],
"by_type": [
{
"type": "laptop",
"count": 1
},
{
"type": "phone",
"count": 1
}
]
}
],
"types": [
{
"type": "laptop",
"total": 1,
"assigned": 1
},
{
"type": "phone",
"total": 1,
"assigned": 1
},
{
"type": "monitor",
"total": 1,
"assigned": 0
}
]
}
}Something missing or wrong on this page? Write to hello@bizisy.com.