Projects and items

Projects, their groups and columns, and the items in them.

GET/v1/projects

List projects

Projects you own or are a member of, newest first, with item counts. Templates aren't included.

Needs projects:readMCP tool list_projects

Query parameters

  • offsetinteger

    At least 0, default 0.

  • limitinteger

    1–100, default 50.

  • include_archivedboolean

    Default false.

Response

  • has_morebooleanRequired

    More results after these; ask again with offset=next_offset

  • next_offsetinteger or null
  • datalist of ProjectRequired
curl "https://developers.playbookops.ai/v1/projects?limit=10" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
Response · 200
{
  "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/…"
    }
  ]
}
GET/v1/projects/{project_id}

Get a project

One project with its groups (in order) and columns. Item values are keyed by column id.

Needs projects:readMCP tool get_project

Path parameters

  • project_idstringRequired

Response

  • idstringRequired
  • titlestringRequired
  • descriptionstring or null
  • statusstringRequired
  • owner_idstring or null
  • owner_namestring or null
  • item_countinteger

    Default 0.

  • completed_item_countinteger

    Default 0.

  • start_datestring (date and time) or null
  • target_end_datestring (date and time) or null
  • created_atstring (date and time) or null
  • urlstringRequired
  • groupslist of GroupRequired
  • columnslist of ColumnRequired
  • your_rolestring or null

    viewer, editor or admin on this project

curl "https://developers.playbookops.ai/v1/projects/PROJECT_ID" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
Response · 200
{
  "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"
}
GET/v1/projects/{project_id}/items

List 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.

Needs projects:readMCP tool list_items

Path parameters

  • project_idstringRequired

Query parameters

  • offsetinteger

    At least 0, default 0.

  • limitinteger

    1–100, default 50.

  • group_idstring or null

    Only items in this group

  • searchstring or null

    Only items whose title contains this

  • include_completedboolean

    Default true.

  • include_subitemsboolean

    Also return subitems, each with its parent_id

    Default false.

Response

  • has_morebooleanRequired

    More results after these; ask again with offset=next_offset

  • next_offsetinteger or null
  • datalist of ItemRequired
curl "https://developers.playbookops.ai/v1/projects/PROJECT_ID/items?limit=10" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
Response · 200
{
  "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/…"
    }
  ]
}
GET/v1/items/search

Search items

Find items by title across every project you're on.

Needs projects:readMCP tool search_items

Query parameters

  • querystringRequired

    Up to 200 characters.

  • limitinteger

    1–50, default 20.

Response

  • has_morebooleanRequired

    More results after these; ask again with offset=next_offset

  • next_offsetinteger or null
  • datalist 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"
Response · 200
{
  "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/…"
    }
  ]
}
GET/v1/items/{item_id}

Get an item

One item (task) with its custom column values, assignee and counts.

Needs projects:readMCP tool get_item

Path parameters

  • item_idstringRequired

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 "https://developers.playbookops.ai/v1/items/ITEM_ID" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
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/…"
}
GET/v1/items/{item_id}/comments

List an item's updates

The updates (comments) posted on a project item, oldest first.

Needs projects:readMCP tool list_item_comments

Path parameters

  • item_idstringRequired

Response

  • datalist of CommentRequired
curl "https://developers.playbookops.ai/v1/items/ITEM_ID/comments" \
  -H "Authorization: Bearer $PLAYBOOKOPS_API_KEY"
Response · 200
{
  "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"
    }
  ]
}
POST/v1/projects/{project_id}/items

Create an item

Add an item to a project, optionally in a group, as a subitem, and with column values.

Needs projects:writeChanges data · supports Idempotency-KeyMCP tool create_item

Path parameters

  • project_idstringRequired

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; null unassigns

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

    null removes the due date

  • group_idstring or null

    Defaults to the project's first group

  • parent_idstring or null

    Make it a subitem of this item

  • valuesobject

    Column id (or key) to its new value; null clears it. Get a project's columns from get_project.

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/projects/PROJECT_ID/items" \
  -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/items/{item_id}/comments

Post an update on an item

Post an update (comment) on a project item. Mentioned people are notified like in the app.

Needs projects:writeChanges data · supports Idempotency-KeyMCP tool add_item_comment

Path parameters

  • item_idstringRequired

Body

  • bodystringRequired

    Plain text or Markdown. Mention people as @Name.

    Up to 20,000 characters.

Response

  • idstringRequired
  • author_idstring or null
  • author_namestring or null
  • bodystringRequired
  • created_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."
}'
Response · 201
{
  "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"
}
POST/v1/items/{item_id}/move

Move 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.

Needs projects:writeChanges data · supports Idempotency-KeyMCP tool move_item

Path parameters

  • item_idstringRequired

Body

  • project_idstringRequired

    The project to move it to

  • group_idstring or null

    A group in that project; defaults to its first group

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/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"
}'
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/…"
}
POST/v1/items/{item_id}/complete

Complete an item

Mark a project item done, or reopen it with completed=false.

Needs projects:writeChanges data · supports Idempotency-KeyMCP tool complete_item

Path parameters

  • item_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/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"
}'
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/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.

Needs projects:writeChanges data · supports Idempotency-KeyMCP tool update_item

Path parameters

  • item_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

  • group_idstring or null

    Move it to another group in the same project

  • valuesobject

    Column id (or key) to its new value; null clears it. Get a project's columns from get_project.

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/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."
}'
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/…"
}