Tasks
Your own tasks across every project.
/v1/tasks/mineMy tasks
Tasks assigned to you across projects and personal lists, sorted into overdue, due today, upcoming and no due date.
tasks:readMCP tool my_tasksQuery parameters
include_completedbooleanDefault false.
Response
overduelist of ItemRequireddue_todaylist of ItemRequiredupcominglist of ItemRequiredno_due_datelist of ItemRequiredtotalintegerRequired
curl "https://developers.playbookops.ai/v1/tasks/mine" \
-H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"{
"overdue": [
{
"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/…"
}
],
"due_today": [
{
"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/…"
}
],
"upcoming": [
{
"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/…"
}
],
"no_due_date": [
{
"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/…"
}
],
"total": 0
}/v1/tasksCreate a task
Add a task outside any project, for you or a teammate. It shows in their My tasks.
tasks:writeChanges data · supports Idempotency-KeyMCP tool create_taskBody
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; defaults to you
start_datestring (date) or nulldue_datestring (date) or nullnull removes the due date
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/tasks" \
-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/tasks/{task_id}/completeComplete a task
Mark one of your tasks done, or reopen it with completed=false.
tasks:writeChanges data · supports Idempotency-KeyMCP tool complete_taskPath parameters
task_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/tasks/TASK_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/tasks/{task_id}Update a task
Change one of your tasks: a personal task, or a project item assigned to you. Only what you send changes; null clears a field.
tasks:writeChanges data · supports Idempotency-KeyMCP tool update_taskPath parameters
task_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
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/tasks/TASK_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/…"
}