Tasks

Your own tasks across every project.

GET/v1/tasks/mine

My tasks

Tasks assigned to you across projects and personal lists, sorted into overdue, due today, upcoming and no due date.

Needs tasks:readMCP tool my_tasks

Query parameters

  • include_completedboolean

    Default false.

Response

  • overduelist of ItemRequired
  • due_todaylist of ItemRequired
  • upcominglist of ItemRequired
  • no_due_datelist of ItemRequired
  • totalintegerRequired
curl "https://developers.playbookops.ai/v1/tasks/mine" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
Response · 200
{
  "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
}
POST/v1/tasks

Create a task

Add a task outside any project, for you or a teammate. It shows in their My tasks.

Needs tasks:writeChanges data · supports Idempotency-KeyMCP tool create_task

Body

  • titlestringRequired

    Up to 500 characters.

  • descriptionstring or null

    Up to 20,000 characters.

  • statusstring or null

    Up to 100 characters.

  • priorityone of "low", "medium", "high", "urgent" or null
  • assignee_idstring or null

    A person's id from list_people; defaults to you

  • start_datestring (date) or null
  • due_datestring (date) or null

    null removes the due date

Response

  • idstringRequired
  • titlestringRequired
  • descriptionstring or null
  • project_idstring or null
  • project_titlestring or null
  • group_idstring or null
  • group_namestring or null
  • statusstringRequired
  • prioritystring or null
  • start_datestring (date) or null
  • due_datestring (date) or null
  • is_completedbooleanRequired
  • completed_atstring (date and time) or null
  • assignee_idstring or null
  • assignee_namestring or null
  • parent_idstring or null
  • valuesobject

    Custom column values, keyed by column id

    Default {}.

  • subitem_countinteger

    Default 0.

  • comment_countinteger

    Default 0.

  • created_atstring (date and time) or null
  • updated_atstring (date and time) or null
  • urlstringRequired
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"
}'
Response · 201
{
  "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/…"
}
POST/v1/tasks/{task_id}/complete

Complete a task

Mark one of your tasks done, or reopen it with completed=false.

Needs tasks:writeChanges data · supports Idempotency-KeyMCP tool complete_task

Path parameters

  • task_idstringRequired

Body

  • completedboolean

    false reopens it

    Default true.

  • notestring or null

    Up to 2,000 characters.

Response

  • idstringRequired
  • titlestringRequired
  • descriptionstring or null
  • project_idstring or null
  • project_titlestring or null
  • group_idstring or null
  • group_namestring or null
  • statusstringRequired
  • prioritystring or null
  • start_datestring (date) or null
  • due_datestring (date) or null
  • is_completedbooleanRequired
  • completed_atstring (date and time) or null
  • assignee_idstring or null
  • assignee_namestring or null
  • parent_idstring or null
  • valuesobject

    Custom column values, keyed by column id

    Default {}.

  • subitem_countinteger

    Default 0.

  • comment_countinteger

    Default 0.

  • created_atstring (date and time) or null
  • updated_atstring (date and time) or null
  • urlstringRequired
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"
}'
Response · 200
{
  "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/…"
}
PATCH/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.

Needs tasks:writeChanges data · supports Idempotency-KeyMCP tool update_task

Path parameters

  • task_idstringRequired

Body

  • titlestring or null

    Up to 500 characters.

  • descriptionstring or null

    Up to 20,000 characters.

  • statusstring or null

    Up to 100 characters.

  • priorityone of "low", "medium", "high", "urgent" or null
  • assignee_idstring or null

    A person's id from list_people; null unassigns

  • start_datestring (date) or null
  • due_datestring (date) or null

    null removes the due date

Response

  • idstringRequired
  • titlestringRequired
  • descriptionstring or null
  • project_idstring or null
  • project_titlestring or null
  • group_idstring or null
  • group_namestring or null
  • statusstringRequired
  • prioritystring or null
  • start_datestring (date) or null
  • due_datestring (date) or null
  • is_completedbooleanRequired
  • completed_atstring (date and time) or null
  • assignee_idstring or null
  • assignee_namestring or null
  • parent_idstring or null
  • valuesobject

    Custom column values, keyed by column id

    Default {}.

  • subitem_countinteger

    Default 0.

  • comment_countinteger

    Default 0.

  • created_atstring (date and time) or null
  • updated_atstring (date and time) or null
  • urlstringRequired
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."
}'
Response · 200
{
  "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/…"
}