API reference
Push notifications
Push notifications per device (a browser or the installed app): availability, turning a device on or off, your devices and preferences, a test. Turned on in the app; machines are refused.
6 actions · base URL https://api.bizisy.com/v1 · generated from the same definitions as the API.
Push notifications: availability#
POST/v1/platform/push.configRead
Whether this server sends push notifications (the operator configured them) and the public key a browser subscribes with. Everyone.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
platform_push_configon My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
No input: send {}.
Returns
availablebooleanrequiredpublic_keystring | nullrequired
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/push.config \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/platform/push.config', {
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/platform/push.config",
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": {
"available": true,
"public_key": "BNc"
}
}Turn on push notifications on this device#
POST/v1/platform/push.subscribeWrite
Registers this browser or installed app for push notifications (the browser's subscription: endpoint on a known push service, its keys, and a label like "Chrome on Android"). At most 10 devices per login (the oldest goes). The payloads carry no names: the app shows the details. In the app only.
- Web app only
- Refused for API keys and connected apps. Push notifications are turned on in a browser or the installed app.
- MCP tool
platform_push_subscribeon 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
endpointURLrequiredUp to 1024 characters.
keysobjectrequired2 fields
p256dhstringrequiredUp to 200 characters.
authstringrequiredUp to 64 characters.
labelstringrequired1–60 characters.
Returns
deviceobjectrequired5 fields
idstringrequiredlabelstringrequiredcreated_atstringrequiredlast_sent_atstring | nullrequiredthis_devicebooleanrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/push.subscribe \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"endpoint": "https://fcm.googleapis.com/fcm/send/abc",
"keys": {
"p256dh": "BOr7",
"auth": "aGk"
},
"label": "Chrome on Android"
}'const res = await fetch('https://api.bizisy.com/v1/platform/push.subscribe', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"endpoint": "https://fcm.googleapis.com/fcm/send/abc",
"keys": {
"p256dh": "BOr7",
"auth": "aGk"
},
"label": "Chrome on Android"
}),
});
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/platform/push.subscribe",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"endpoint": "https://fcm.googleapis.com/fcm/send/abc",
"keys": {
"p256dh": "BOr7",
"auth": "aGk",
},
"label": "Chrome on Android",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"device": {
"id": "d1",
"label": "Chrome on Android",
"created_at": "2026-10-12T09:00:00.000Z",
"last_sent_at": null,
"this_device": true
}
}
}Turn off push notifications on a device#
POST/v1/platform/push.unsubscribeWrite
Removes one of your devices (by id from platform_push_devices, or this browser's endpoint). Nothing more is sent to it.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
platform_push_unsubscribeon 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
device_idstring1–60 characters.
endpointstringUp to 1024 characters.
Returns
removedintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/push.unsubscribe \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"endpoint":"https://fcm.googleapis.com/fcm/send/abc"}'const res = await fetch('https://api.bizisy.com/v1/platform/push.unsubscribe', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"endpoint": "https://fcm.googleapis.com/fcm/send/abc"
}),
});
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/platform/push.unsubscribe",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"endpoint": "https://fcm.googleapis.com/fcm/send/abc",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"removed": 1
}
}My push devices#
POST/v1/platform/push.devicesRead
Your devices with push notifications on (label, since when, last sent; endpoint = this browser's marks it) and your preferences per kind. Never the endpoints.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
platform_push_deviceson My Workplace, HR Assistant- Method
POSTwith a JSON body, orGETwith the input as query parameters
Input
endpointstringUp to 1024 characters.
Returns
itemsobject[]required5 fields
idstringrequiredlabelstringrequiredcreated_atstringrequiredlast_sent_atstring | nullrequiredthis_devicebooleanrequired
prefsobjectrequired5 fields
approvalsbooleanrequiredRequests waiting for your decision and decisions on yours (changes, time off, time corrections).
clockbooleanrequiredTime clock: still clocked in after your day, your month to acknowledge.
documentsbooleanrequiredDocuments shared with you (and, for HR, documents people added).
remindersbooleanrequiredDaily reminders and checklist tasks.
announcementsbooleanrequiredAnnouncements published to you.
Errors
validation_failed unauthenticated forbidden not_found rate_limited internal
curl https://api.bizisy.com/v1/platform/push.devices \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"endpoint":"https://fcm.googleapis.com/fcm/send/abc"}'const res = await fetch('https://api.bizisy.com/v1/platform/push.devices', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"endpoint": "https://fcm.googleapis.com/fcm/send/abc"
}),
});
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/platform/push.devices",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}"},
json={
"endpoint": "https://fcm.googleapis.com/fcm/send/abc",
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"items": [
{
"id": "d1",
"label": "Chrome on Android",
"created_at": "2026-10-12T09:00:00.000Z",
"last_sent_at": null,
"this_device": true
}
],
"prefs": {
"approvals": true,
"clock": true,
"documents": true,
"reminders": false,
"announcements": true
}
}
}Push notification preferences#
POST/v1/platform/push.prefsWrite
Which kinds of notices you get as push on your devices: approvals, clock, documents, reminders, announcements (all on by default once a device is on). They stay in the app either way.
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
platform_push_prefson My Workplace, HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
approvalsbooleanRequests waiting for your decision and decisions on yours (changes, time off, time corrections).
clockbooleanTime clock: still clocked in after your day, your month to acknowledge.
documentsbooleanDocuments shared with you (and, for HR, documents people added).
remindersbooleanDaily reminders and checklist tasks.
announcementsbooleanAnnouncements published to you.
Returns
approvalsbooleanrequiredRequests waiting for your decision and decisions on yours (changes, time off, time corrections).
clockbooleanrequiredTime clock: still clocked in after your day, your month to acknowledge.
documentsbooleanrequiredDocuments shared with you (and, for HR, documents people added).
remindersbooleanrequiredDaily reminders and checklist tasks.
announcementsbooleanrequiredAnnouncements published to you.
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/push.prefs \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"approvals": true,
"clock": true,
"documents": false,
"reminders": false,
"announcements": true
}'const res = await fetch('https://api.bizisy.com/v1/platform/push.prefs', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
"approvals": true,
"clock": true,
"documents": false,
"reminders": false,
"announcements": 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/platform/push.prefs",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={
"approvals": True,
"clock": True,
"documents": False,
"reminders": False,
"announcements": True,
},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"approvals": true,
"clock": true,
"documents": false,
"reminders": false,
"announcements": true
}
}Send a test push#
POST/v1/platform/push.testWrite
Sends a test notification to your devices within a minute (at most 5 an hour).
- Who can call it
- Manage key any Manage role
Me key anyone - MCP tool
platform_push_teston My Workplace, HR Assistant- Preview
?dry_run=trueruns every check and saves nothing- Retries
- An Idempotency-Key replays the first result
Input
device_idstringUp to 60 characters.
Returns
queuedintegerrequired
Errors
validation_failed unauthenticated forbidden not_found conflict rate_limited internal
curl https://api.bizisy.com/v1/platform/push.test \
-H "Authorization: Bearer $BIZISY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{}'const res = await fetch('https://api.bizisy.com/v1/platform/push.test', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BIZISY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
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, uuid
import requests
res = requests.post(
"https://api.bizisy.com/v1/platform/push.test",
headers={"Authorization": f"Bearer {os.environ['BIZISY_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"]){
"data": {
"queued": 1
}
}Something missing or wrong on this page? Write to hello@bizisy.com.