Apps
Your organization's apps and the records in them.
/v1/appsList apps
Published apps built in PlaybookOps that you can open.
apps:readMCP tool list_appsResponse
datalist of AppRequired
curl "https://developers.playbookops.ai/v1/apps" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"description": "Confirm the date and ask about parking.",
"url": "https://app.playbookops.ai/…"
}
]
}/v1/apps/{app_id}Get an app
One app with its collections (tables) and their fields, so you know what to ask for.
apps:readMCP tool get_appPath parameters
app_idstringRequired
Response
idstringRequirednamestringRequireddescriptionstring or nullurlstringRequiredcollectionslist of AppCollectionRequired
curl "https://developers.playbookops.ai/v1/apps/APP_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"description": "Confirm the date and ask about parking.",
"url": "https://app.playbookops.ai/…",
"collections": [
{
"name": "Ana Ruiz",
"display_field": "…",
"fields": [
{
"name": null,
"type": null,
"required": false,
"options": null,
"links_to": null,
"many": false
}
]
}
]
}/v1/apps/{app_id}/collections/{collection}/records/{record_id}Get an app record
One Live record from an app's collection.
apps:readMCP tool get_app_recordPath parameters
app_idstringRequiredcollectionstringRequiredrecord_idstringRequired
Response
idstringRequiredcollectionstringRequireddataobjectRequiredcreated_atstring (date and time) or nullupdated_atstring (date and time) or null
curl "https://developers.playbookops.ai/v1/apps/APP_ID/collections/COLLECTION/records/RECORD_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"collection": "…",
"data": {},
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z"
}/v1/apps/{app_id}/collections/{collection}/recordsList an app's records
Live records in one of an app's collections. Filter by field (eq, neq, gt, lt, in, contains, has), sort, and page with offset.
apps:readMCP tool list_app_recordsPath parameters
app_idstringRequiredcollectionstringRequired
Query parameters
filterlist of stringRepeat for each filter, as field:op:value, like status:eq:open or amount:gt:100. Ops: eq, neq, gt, lt, in, contains, has.
Default [].
sortstring or nullA field to sort by; start it with - for largest or latest first
offsetintegerAt least 0, default 0.
limitinteger1–100, default 50.
Response
has_morebooleanRequiredMore results after these; ask again with offset=next_offset
next_offsetinteger or nulldatalist of AppRecordRequired
curl "https://developers.playbookops.ai/v1/apps/APP_ID/collections/COLLECTION/records?limit=10" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"has_more": false,
"next_offset": 0,
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"collection": "…",
"data": {},
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z"
}
]
}/v1/apps/{app_id}/collections/{collection}/recordsCreate an app record
Add a Live record to one of an app's collections. Fields are checked against the app like in the app itself.
apps:writeChanges data · supports Idempotency-KeyMCP tool create_app_recordPath parameters
app_idstringRequiredcollectionstringRequired
Body
dataobjectRequiredThe record's fields by name, as listed by get_app. Fields starting with _ are reserved.
Response
idstringRequiredcollectionstringRequireddataobjectRequiredcreated_atstring (date and time) or nullupdated_atstring (date and time) or null
curl -X POST "https://developers.playbookops.ai/v1/apps/APP_ID/collections/COLLECTION/records" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"data": {}
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"collection": "…",
"data": {},
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z"
}/v1/apps/{app_id}/collections/{collection}/records/{record_id}Update an app record
Change some fields on a Live app record. Fields you leave out stay as they are.
apps:writeChanges data · supports Idempotency-KeyMCP tool update_app_recordPath parameters
app_idstringRequiredcollectionstringRequiredrecord_idstringRequired
Body
dataobjectRequiredOnly the fields to change; null clears one. The record's fields by name, as listed by get_app. Fields starting with _ are reserved.
Response
idstringRequiredcollectionstringRequireddataobjectRequiredcreated_atstring (date and time) or nullupdated_atstring (date and time) or null
curl -X PATCH "https://developers.playbookops.ai/v1/apps/APP_ID/collections/COLLECTION/records/RECORD_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"data": {}
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"collection": "…",
"data": {},
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z"
}