Projects and items
Projects, their groups and columns, and the items in them.
/v1/projectsList projects
Projects you own or are a member of, newest first, with item counts. Templates aren't included.
projects:readMCP tool list_projectsQuery parameters
offsetintegerAt least 0, default 0.
limitinteger1–100, default 50.
include_archivedbooleanDefault false.
Response
has_morebooleanRequiredMore results after these; ask again with offset=next_offset
next_offsetinteger or nulldatalist of ProjectRequired
curl "https://developers.playbookops.ai/v1/projects?limit=10" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"has_more": false,
"next_offset": 0,
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"status": "in_progress",
"owner_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"owner_name": "Ana Ruiz",
"item_count": 0,
"completed_item_count": 0,
"start_date": "2026-11-21T15:04:05Z",
"target_end_date": "2026-11-21T15:04:05Z",
"created_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}
]
}/v1/projects/{project_id}Get a project
One project with its groups (in order) and columns. Item values are keyed by column id.
projects:readMCP tool get_projectPath parameters
project_idstringRequired
Response
idstringRequiredtitlestringRequireddescriptionstring or nullstatusstringRequiredowner_idstring or nullowner_namestring or nullitem_countintegerDefault 0.
completed_item_countintegerDefault 0.
start_datestring (date and time) or nulltarget_end_datestring (date and time) or nullcreated_atstring (date and time) or nullurlstringRequiredgroupslist of GroupRequiredcolumnslist of ColumnRequiredyour_rolestring or nullviewer, editor or admin on this project
curl "https://developers.playbookops.ai/v1/projects/PROJECT_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"status": "in_progress",
"owner_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"owner_name": "Ana Ruiz",
"item_count": 0,
"completed_item_count": 0,
"start_date": "2026-11-21T15:04:05Z",
"target_end_date": "2026-11-21T15:04:05Z",
"created_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…",
"groups": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"name": "Ana Ruiz",
"position": 0,
"color": "#22c55e"
}
],
"columns": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"key": "…",
"name": "Ana Ruiz",
"type": "…",
"is_built_in": false,
"description": "Confirm the date and ask about parking.",
"options": []
}
],
"your_role": "editor"
}/v1/projects/{project_id}/itemsList a project's items
A project's items in board order, with their custom column values. Filter by group, title or completion; page with offset.
projects:readMCP tool list_itemsPath parameters
project_idstringRequired
Query parameters
offsetintegerAt least 0, default 0.
limitinteger1–100, default 50.
group_idstring or nullOnly items in this group
searchstring or nullOnly items whose title contains this
include_completedbooleanDefault true.
include_subitemsbooleanAlso return subitems, each with its parent_id
Default false.
Response
has_morebooleanRequiredMore results after these; ask again with offset=next_offset
next_offsetinteger or nulldatalist of ItemRequired
curl "https://developers.playbookops.ai/v1/projects/PROJECT_ID/items?limit=10" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"has_more": false,
"next_offset": 0,
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"project_title": "Spring launch",
"group_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"group_name": "This week",
"status": "in_progress",
"priority": "high",
"start_date": "2026-11-21",
"due_date": "2026-11-21",
"is_completed": false,
"completed_at": "2026-11-21T15:04:05Z",
"assignee_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"assignee_name": "Ana Ruiz",
"parent_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"values": {},
"subitem_count": 0,
"comment_count": 0,
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}
]
}/v1/items/searchSearch items
Find items by title across every project you're on.
projects:readMCP tool search_itemsQuery parameters
querystringRequiredUp to 200 characters.
limitinteger1–50, default 20.
Response
has_morebooleanRequiredMore results after these; ask again with offset=next_offset
next_offsetinteger or nulldatalist of ItemRequired
curl "https://developers.playbookops.ai/v1/items/search?query=How%20do%20we%20handle%20refunds%20over%20%24500%3F&limit=10" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"has_more": false,
"next_offset": 0,
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"project_title": "Spring launch",
"group_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"group_name": "This week",
"status": "in_progress",
"priority": "high",
"start_date": "2026-11-21",
"due_date": "2026-11-21",
"is_completed": false,
"completed_at": "2026-11-21T15:04:05Z",
"assignee_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"assignee_name": "Ana Ruiz",
"parent_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"values": {},
"subitem_count": 0,
"comment_count": 0,
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}
]
}/v1/items/{item_id}Get an item
One item (task) with its custom column values, assignee and counts.
projects:readMCP tool get_itemPath parameters
item_idstringRequired
Response
idstringRequiredtitlestringRequireddescriptionstring or nullproject_idstring or nullproject_titlestring or nullgroup_idstring or nullgroup_namestring or nullstatusstringRequiredprioritystring or nullstart_datestring (date) or nulldue_datestring (date) or nullis_completedbooleanRequiredcompleted_atstring (date and time) or nullassignee_idstring or nullassignee_namestring or nullparent_idstring or nullvaluesobjectCustom column values, keyed by column id
Default {}.
subitem_countintegerDefault 0.
comment_countintegerDefault 0.
created_atstring (date and time) or nullupdated_atstring (date and time) or nullurlstringRequired
curl "https://developers.playbookops.ai/v1/items/ITEM_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"project_title": "Spring launch",
"group_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"group_name": "This week",
"status": "in_progress",
"priority": "high",
"start_date": "2026-11-21",
"due_date": "2026-11-21",
"is_completed": false,
"completed_at": "2026-11-21T15:04:05Z",
"assignee_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"assignee_name": "Ana Ruiz",
"parent_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"values": {},
"subitem_count": 0,
"comment_count": 0,
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}/v1/items/{item_id}/commentsList an item's updates
The updates (comments) posted on a project item, oldest first.
projects:readMCP tool list_item_commentsPath parameters
item_idstringRequired
Response
datalist of CommentRequired
curl "https://developers.playbookops.ai/v1/items/ITEM_ID/comments" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"data": [
{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"author_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"author_name": "Ana Ruiz",
"body": "Booked for the 5th.",
"created_at": "2026-11-21T15:04:05Z"
}
]
}/v1/projects/{project_id}/itemsCreate an item
Add an item to a project, optionally in a group, as a subitem, and with column values.
projects:writeChanges data · supports Idempotency-KeyMCP tool create_itemPath parameters
project_idstringRequired
Body
titlestringRequiredUp to 500 characters.
descriptionstring or nullUp to 20,000 characters.
statusstring or nullUp to 100 characters.
priorityone of "low", "medium", "high", "urgent" or nullassignee_idstring or nullA person's id from list_people; null unassigns
start_datestring (date) or nulldue_datestring (date) or nullnull removes the due date
group_idstring or nullDefaults to the project's first group
parent_idstring or nullMake it a subitem of this item
valuesobjectColumn id (or key) to its new value; null clears it. Get a project's columns from get_project.
Response
idstringRequiredtitlestringRequireddescriptionstring or nullproject_idstring or nullproject_titlestring or nullgroup_idstring or nullgroup_namestring or nullstatusstringRequiredprioritystring or nullstart_datestring (date) or nulldue_datestring (date) or nullis_completedbooleanRequiredcompleted_atstring (date and time) or nullassignee_idstring or nullassignee_namestring or nullparent_idstring or nullvaluesobjectCustom column values, keyed by column id
Default {}.
subitem_countintegerDefault 0.
comment_countintegerDefault 0.
created_atstring (date and time) or nullupdated_atstring (date and time) or nullurlstringRequired
curl -X POST "https://developers.playbookops.ai/v1/projects/PROJECT_ID/items" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"title": "Call the venue"
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"project_title": "Spring launch",
"group_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"group_name": "This week",
"status": "in_progress",
"priority": "high",
"start_date": "2026-11-21",
"due_date": "2026-11-21",
"is_completed": false,
"completed_at": "2026-11-21T15:04:05Z",
"assignee_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"assignee_name": "Ana Ruiz",
"parent_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"values": {},
"subitem_count": 0,
"comment_count": 0,
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}/v1/items/{item_id}/commentsPost an update on an item
Post an update (comment) on a project item. Mentioned people are notified like in the app.
projects:writeChanges data · supports Idempotency-KeyMCP tool add_item_commentPath parameters
item_idstringRequired
Body
bodystringRequiredPlain text or Markdown. Mention people as @Name.
Up to 20,000 characters.
Response
idstringRequiredauthor_idstring or nullauthor_namestring or nullbodystringRequiredcreated_atstring (date and time)Required
curl -X POST "https://developers.playbookops.ai/v1/items/ITEM_ID/comments" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"body": "Booked for the 5th."
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"author_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"author_name": "Ana Ruiz",
"body": "Booked for the 5th.",
"created_at": "2026-11-21T15:04:05Z"
}/v1/items/{item_id}/moveMove an item to another project
Move an item and its subitems to another project you can edit. Column values move to columns with the same name and type.
projects:writeChanges data · supports Idempotency-KeyMCP tool move_itemPath parameters
item_idstringRequired
Body
project_idstringRequiredThe project to move it to
group_idstring or nullA group in that project; defaults to its first group
Response
idstringRequiredtitlestringRequireddescriptionstring or nullproject_idstring or nullproject_titlestring or nullgroup_idstring or nullgroup_namestring or nullstatusstringRequiredprioritystring or nullstart_datestring (date) or nulldue_datestring (date) or nullis_completedbooleanRequiredcompleted_atstring (date and time) or nullassignee_idstring or nullassignee_namestring or nullparent_idstring or nullvaluesobjectCustom column values, keyed by column id
Default {}.
subitem_countintegerDefault 0.
comment_countintegerDefault 0.
created_atstring (date and time) or nullupdated_atstring (date and time) or nullurlstringRequired
curl -X POST "https://developers.playbookops.ai/v1/items/ITEM_ID/move" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42"
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"project_title": "Spring launch",
"group_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"group_name": "This week",
"status": "in_progress",
"priority": "high",
"start_date": "2026-11-21",
"due_date": "2026-11-21",
"is_completed": false,
"completed_at": "2026-11-21T15:04:05Z",
"assignee_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"assignee_name": "Ana Ruiz",
"parent_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"values": {},
"subitem_count": 0,
"comment_count": 0,
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}/v1/items/{item_id}/completeComplete an item
Mark a project item done, or reopen it with completed=false.
projects:writeChanges data · supports Idempotency-KeyMCP tool complete_itemPath parameters
item_idstringRequired
Body
completedbooleanfalse reopens it
Default true.
notestring or nullUp to 2,000 characters.
Response
idstringRequiredtitlestringRequireddescriptionstring or nullproject_idstring or nullproject_titlestring or nullgroup_idstring or nullgroup_namestring or nullstatusstringRequiredprioritystring or nullstart_datestring (date) or nulldue_datestring (date) or nullis_completedbooleanRequiredcompleted_atstring (date and time) or nullassignee_idstring or nullassignee_namestring or nullparent_idstring or nullvaluesobjectCustom column values, keyed by column id
Default {}.
subitem_countintegerDefault 0.
comment_countintegerDefault 0.
created_atstring (date and time) or nullupdated_atstring (date and time) or nullurlstringRequired
curl -X POST "https://developers.playbookops.ai/v1/items/ITEM_ID/complete" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"completed": true,
"note": "Up after the spring campaign"
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"project_title": "Spring launch",
"group_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"group_name": "This week",
"status": "in_progress",
"priority": "high",
"start_date": "2026-11-21",
"due_date": "2026-11-21",
"is_completed": false,
"completed_at": "2026-11-21T15:04:05Z",
"assignee_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"assignee_name": "Ana Ruiz",
"parent_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"values": {},
"subitem_count": 0,
"comment_count": 0,
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}/v1/items/{item_id}Update an item
Change an item's title, status, assignee, dates, group or column values. Only what you send changes; null clears a field.
projects:writeChanges data · supports Idempotency-KeyMCP tool update_itemPath parameters
item_idstringRequired
Body
titlestring or nullUp to 500 characters.
descriptionstring or nullUp to 20,000 characters.
statusstring or nullUp to 100 characters.
priorityone of "low", "medium", "high", "urgent" or nullassignee_idstring or nullA person's id from list_people; null unassigns
start_datestring (date) or nulldue_datestring (date) or nullnull removes the due date
group_idstring or nullMove it to another group in the same project
valuesobjectColumn id (or key) to its new value; null clears it. Get a project's columns from get_project.
Response
idstringRequiredtitlestringRequireddescriptionstring or nullproject_idstring or nullproject_titlestring or nullgroup_idstring or nullgroup_namestring or nullstatusstringRequiredprioritystring or nullstart_datestring (date) or nulldue_datestring (date) or nullis_completedbooleanRequiredcompleted_atstring (date and time) or nullassignee_idstring or nullassignee_namestring or nullparent_idstring or nullvaluesobjectCustom column values, keyed by column id
Default {}.
subitem_countintegerDefault 0.
comment_countintegerDefault 0.
created_atstring (date and time) or nullupdated_atstring (date and time) or nullurlstringRequired
curl -X PATCH "https://developers.playbookops.ai/v1/items/ITEM_ID" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"title": "Call the venue",
"description": "Confirm the date and ask about parking."
}'{
"id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"title": "Call the venue",
"description": "Confirm the date and ask about parking.",
"project_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"project_title": "Spring launch",
"group_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"group_name": "This week",
"status": "in_progress",
"priority": "high",
"start_date": "2026-11-21",
"due_date": "2026-11-21",
"is_completed": false,
"completed_at": "2026-11-21T15:04:05Z",
"assignee_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"assignee_name": "Ana Ruiz",
"parent_id": "6f1d2c1e-8a3b-4b8e-9d55-2c0f9e7a1b42",
"values": {},
"subitem_count": 0,
"comment_count": 0,
"created_at": "2026-11-21T15:04:05Z",
"updated_at": "2026-11-21T15:04:05Z",
"url": "https://app.playbookops.ai/…"
}