Plan · Boards

List boards

The boards you can see, as a page. Filter by project, search with search, by dates with start_date / end_date, and bring archived boards with include_archived. An agent or organization key sees organization-visible boards only; a personal key sees what its person sees.

curl -sS "https://api.dailybot.com/v1/plan/boards/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board list --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000002",
      "key": "ENG",
      "name": "Engineering",
      "project": {
        "uuid": "00000000-0000-4000-8000-000000000001",
        "name": "Platform",
        "is_archived": false
      },
      "team": null,
      "visibility": "org",
      "estimate_scale": "fibonacci",
      "default_view": null,
      "archive_after_days": null,
      "task_count": 12,
      "wip_limits": {},
      "is_archived": false,
      "created_at": "2026-09-25T10:14:02Z",
      "updated_at": "2026-09-25T10:14:02Z",
      "viewer": {},
      "states": []
    }
  ]
}

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

Retrieve a board

One board by uuid. A board you cannot see answers 404, the same as one that does not exist.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board get 00000000-0000-4000-8000-000000000002

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

List a board's workflow states, in column order

The board's workflow states (its columns), ordered by position. Each has a category (such as in_progress) that stays stable when a state is renamed. Add include_archived=true to see archived states.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/states/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board states 00000000-0000-4000-8000-000000000002 --include-archived

[
  {
    "uuid": "00000000-0000-4000-8000-000000000003",
    "name": "In Progress",
    "category": "in_progress",
    "position": 2,
    "color": "#2563eb",
    "is_default": false,
    "is_archived": false,
    "task_count": 12
  }
]

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

The whole board — states and their tasks — in one round trip

One call renders a board: one entry in groups per column, in column order, each with its first tasks in rank order, the column's true task_count and has_more. Page the rest of a column with GET /v1/plan/tasks/?board=…&state=….

Store delta_cursor and switch to the delta feed for every later read. Answers If-None-Match with 304. …/snapshot/ is an alias with the same response. Unknown query parameters and invalid filter values are 400 invalid_filter_value.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/board/?tasks_per_state=25" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board snapshot 00000000-0000-4000-8000-000000000002 --json

{
  "board": {
    "uuid": "00000000-0000-4000-8000-000000000100",
    "key": "ENG",
    "name": "Engineering",
    "visibility": "org",
    "estimate_scale": "fibonacci",
    "project": {
      "uuid": "00000000-0000-4000-8000-000000000101",
      "name": "Platform"
    }
  },
  "generated_at": "2026-08-29T10:14:02.113954Z",
  "delta_cursor": "2026-08-29T10:14:02.113954Z",
  "group_by": "state",
  "groups": [
    {
      "key": "00000000-0000-4000-8000-000000000102",
      "name": "In Progress",
      "category": "in_progress",
      "position": 2,
      "color": "#f59e0b",
      "task_count": 137,
      "has_more": true,
      "tasks": [
        {
          "uuid": "00000000-0000-4000-8000-000000000103",
          "key": "ENG-142",
          "title": "Ship the delta feed",
          "state": {
            "uuid": "00000000-0000-4000-8000-000000000102",
            "name": "In Progress",
            "category": "in_progress"
          },
          "priority": 2,
          "estimate": 3,
          "rank": "aU",
          "version": 7,
          "open_blocker_count": 1,
          "participant_count": 3,
          "owner": {
            "uuid": "00000000-0000-4000-8000-000000000104",
            "name": "Ada L."
          },
          "executor": null,
          "due_date": "2026-09-04",
          "labels": [
            {
              "uuid": "00000000-0000-4000-8000-000000000105",
              "name": "backend",
              "color": "#2563eb"
            }
          ],
          "is_archived": false,
          "updated_at": "2026-08-29T10:12:44.201113Z"
        }
      ]
    }
  ]
}

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

What changed on this board since a timestamp. NOT pagination

A change feed, not a page: no count, next or previous. Send the cursor from your previous response (or the snapshot's delta_cursor) verbatim as updated_since; never compute it from your own clock.

Delivery is at-least-once, so a row written in the same instant as your cursor is sent again rather than lost. Entries are compacted to one per task (the current row wins). states is null unless a column was created, renamed, reordered or archived; when it is set, replace your whole column list.

Poll again after poll_after_seconds (15 s, doubling to 120 s while the board is quiet, reset on any change). Pause while the page is hidden and refresh when it becomes visible. If truncated is true, poll again immediately. Cursors older than 7 days return 400 delta_window_expired: re-read the snapshot. Polling is the v1 transport.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/delta/?updated_since=2026-09-25T10:14:02.113954Z" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan tasks changes 00000000-0000-4000-8000-000000000002 --updated-since 2026-09-25T10:14:02.113954Z --json

{
  "since": "2026-08-29T10:14:02.113954Z",
  "cursor": "2026-08-29T10:19:44.902311Z",
  "changed": [
    {
      "uuid": "00000000-0000-4000-8000-000000000100",
      "key": "ENG-142",
      "title": "Ship the delta feed",
      "state": {
        "uuid": "00000000-0000-4000-8000-000000000101",
        "name": "Done",
        "category": "done"
      },
      "priority": 2,
      "rank": "b0",
      "version": 9,
      "is_archived": false,
      "updated_at": "2026-08-29T10:19:44.902311Z"
    }
  ],
  "removed": [
    {
      "uuid": "00000000-0000-4000-8000-000000000102",
      "key": "ENG-77",
      "reason": "archived"
    }
  ],
  "states": null,
  "truncated": false,
  "poll_after_seconds": 15
}

• Scope: `tasks:read`.
• Rate limit: 240 delta polls per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

The caller's saved views for this board

Your saved views for this board. Views are personal. Needs a person: agent and organization keys are refused; a personal API key works.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/views/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan board views 00000000-0000-4000-8000-000000000002 --etag

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "name": "My open work",
      "view_mode": "list",
      "group_by": "state",
      "sort": "-updated_at",
      "filters": {},
      "schema_version": 1,
      "visibility": "personal",
      "collapsed": {},
      "columns": {}
    }
  ]
}

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Needs a person: call it with a login session, a CLI user token or a personal API key. An agent or organization key gets `403 insufficient_scope`.

Search people mentionable on a board

The roster for owner and participant pickers, searchable with q (name, handle or external id, never a whole email address). Do not use the members list for pickers: it only lists explicit grants and is often empty on organization-visible boards.

People who cannot see the board never appear, even when they match q, matching the rule that refuses them as owner or participant (participant_cannot_access_board). limit (default 25) and offset page the whole roster in a stable order.

Rows are {uuid, name, handle, avatar_url, has_photo, kind}, with no email. avatar_url and has_photo mean the same as on a task owner: when has_photo is false, show initials; on an agent row they are null and false. Key mention chips on uuid, never handle: handle is not unique within an organization, so show name to disambiguate. kinds=agent lists the workspace's agents, but an agent cannot be mentioned yet; do not build a mention from an agent row.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/mentionables/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan board mentionables 00000000-0000-4000-8000-000000000002 -q ada

{
  "limit": 25,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000c",
      "name": "Ada L.",
      "handle": "ada",
      "avatar_url": "https://example.com/avatars/ada.png",
      "has_photo": true,
      "kind": "user"
    },
    {
      "uuid": "00000000-0000-4000-8000-000000000012",
      "name": "Grace H.",
      "handle": null,
      "avatar_url": null,
      "has_photo": false,
      "kind": "user"
    }
  ]
}

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Needs a person: call it with a login session, a CLI user token or a personal API key. An agent or organization key gets `403 insufficient_scope`.

Members of a board

Explicit membership grants only, never the full organization roster, so organization-visible boards often return an empty list. Use it to manage who may see a members-only board; for pickers use …/mentionables/. An organization admin can read this list without gaining sight of the board's tasks.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/members/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board members 00000000-0000-4000-8000-000000000002

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "subject_type": "user",
      "user_uuid": "00000000-0000-4000-8000-00000000000c",
      "uuid": "00000000-0000-4000-8000-00000000000c",
      "full_name": "Ada L.",
      "name": "Ada L.",
      "role": "admin",
      "team_uuid": null,
      "team_name": "example",
      "added_at": "2026-09-25T10:14:02Z",
      "added_by_uuid": null
    }
  ]
}

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

List organization labels (board access gate)

The organization's labels, behind this board's access check, so board settings can manage them without leaving the Plan API. Apply labels to cards with task PATCH, the labels batch endpoint or bulk set_labels.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/labels/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan board labels 00000000-0000-4000-8000-000000000002

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000b",
      "name": "backend",
      "color": "#2563eb"
    }
  ]
}

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Needs a person: call it with a login session, a CLI user token or a personal API key. An agent or organization key gets `403 insufficient_scope`.

One saved view by uuid

Readable when it is your own view, or a shared or board_default view on a board you can see. Anything else, including another person's personal view, is 404, never 403.

curl -sS "https://api.dailybot.com/v1/plan/views/{view_id}/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks view get 00000000-0000-4000-8000-000000000010 --json

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Needs a person: call it with a login session, a CLI user token or a personal API key. An agent or organization key gets `403 insufficient_scope`.

List a board's attachments

The board's ready attachments, ordered by position, as a page. Anyone who can see the board can list them; a board you cannot see is 404. Each url is a download link: do not store it, keep the attachment uuid and read it again when you need the file.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/attachments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000009",
      "filename": "roadmap.pdf",
      "content_type": "application/pdf",
      "size": 48213,
      "url": "https://media.dailybot.com/\u2026",
      "url_expires_at": null,
      "content_url": "/v1/plan/boards/00000000-0000-4000-8000-000000000002/attachments/00000000-0000-4000-8000-000000000009/content/",
      "thumbnail_url": null,
      "width": null,
      "height": null,
      "status": "ready",
      "uploaded_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-000000000001",
        "name": "Ana"
      },
      "created_at": "2026-09-30T14:00:00Z"
    }
  ]
}

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

Retrieve a board attachment

One attachment of the board. Anyone who can see the board can read it.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.

Download a board attachment's bytes

The file bytes, with the recorded content type, through the API rather than the media link. An attachment whose upload is not complete yet is 409 attachment_not_ready.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -o roadmap.pdf

• Scope: `tasks:read`.
• Rate limit: 120 reads per minute per actor.
• Works with a login session, a CLI user token, a personal API key, or an agent or organization key. A personal key sees what its person sees; an agent or organization key acts as a system actor and sees organization-visible boards only.