Plan · Projects

List projects

The projects you can see, as a page. Search with search, filter by dates with start_date / end_date, and bring archived projects with include_archived. include adds optional blocks to each row.

curl -sS "https://api.dailybot.com/v1/plan/projects/?include=progress" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan project list --include progress --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000001",
      "name": "Platform",
      "slug": "platform",
      "description": null,
      "lead": {
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "goals": [],
      "goal": {},
      "board_count": 1,
      "health": "on_track",
      "start_date": "2026-09-28",
      "target_date": "2026-10-15",
      "progress": {
        "total": 10,
        "completed": 4,
        "percent_complete": 40
      },
      "is_archived": false,
      "archived_at": null,
      "created_at": "2026-09-25T10:14:02Z",
      "updated_at": "2026-09-25T10:14:02Z",
      "viewer": {}
    }
  ]
}

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

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

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

dailybot plan project get 00000000-0000-4000-8000-000000000001 --include progress

• 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 newest updates across every project the caller can see

The batched form of the per-project updates list, for a home screen that would otherwise call it once per project.

Returns the newest per_project updates for each visible project as one flat, paginated list; each row carries its project, so group by that field. Ordered by project name, then newest first. It is a teaser, not a history: for a full thread or an archived project, use GET /v1/plan/projects/{project_id}/updates/.

projects narrows to named projects. A project you cannot see is silently omitted rather than refused, and archived projects are excluded even when named. body_html is rendered and sanitized server-side.

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

dailybot plan project updates --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000e",
      "project": "00000000-0000-4000-8000-000000000001",
      "body": "Staging is green; rolling out Friday.",
      "body_html": "<p>Staging is green; rolling out Friday.</p>",
      "mentions": [],
      "health": "on_track",
      "created_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "created_at": "2026-09-25T10:14:02Z",
      "updated_at": "2026-09-25T10:14:02Z"
    }
  ]
}

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

Status notes on a project, newest first

The narrative half of a roadmap: why the health is what it is, with a name and a date on it. body is the markdown as typed; body_html is rendered server-side through the same sanitizer comments use, so no client-supplied HTML is ever trusted.

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

dailybot plan project updates 00000000-0000-4000-8000-000000000001 --json

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

Dated commitments inside a project, in date order

Each row carries task_count, annotated in the same query — a roadmap draws every marker at once, so a count per marker would be a query per row.

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

dailybot plan project milestones 00000000-0000-4000-8000-000000000001

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000007",
      "name": "Beta launch",
      "description": null,
      "date": "2026-09-28",
      "task_count": 12,
      "is_archived": false,
      "completed_at": null,
      "created_at": "2026-09-25T10:14:02Z",
      "updated_at": "2026-09-25T10:14:02Z"
    }
  ]
}

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

Every milestone the viewer may see, across projects

Every milestone you may see across projects, in one call, for a roadmap's markers. Visibility follows the projects you can open. project__in narrows that set and never widens it: an unknown uuid and another organization's uuid both return an empty result. Rows carry project as a reference.

curl -sS "https://api.dailybot.com/v1/plan/milestones/?project__in=00000000-0000-4000-8000-000000000001" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan project milestones

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000007",
      "name": "Beta launch",
      "description": null,
      "date": "example",
      "task_count": 12,
      "is_archived": false,
      "project": {},
      "created_at": "example",
      "updated_at": "example"
    }
  ]
}

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

This person's saved views inside a project

Your saved views inside a project: named filter sets that span every board in it. Views are personal and scoped by project, so the same name can exist in two projects. Needs a person: agent and organization keys are refused; a personal API key works.

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

dailybot plan project views 00000000-0000-4000-8000-000000000001 --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`.

Members of a project

Visible to anyone who can see the project. On a members project this is the membership that grants sight of the project and its boards.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/members/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan project members 00000000-0000-4000-8000-000000000001

{
  "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.
• 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 project's attachments

The project's attachments, ordered by position. Anyone who can see the project can list its attachments; a project 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. To show an image in the project's description, reference it as attachment:{uuid} and resolve it when you render, using the fresh url from this list.

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

dailybot plan project attachments 00000000-0000-4000-8000-000000000001 --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000009",
      "filename": "screenshot.png",
      "content_type": "image/png",
      "size": 1,
      "url": "https://your.app/files/screenshot.png",
      "thumbnail_url": null,
      "width": null,
      "height": null,
      "status": "ready",
      "uploaded_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "created_at": "2026-09-25T10:14:02Z"
    }
  ]
}

• 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 project attachment's bytes

Streams the file with the content type recorded at upload, X-Content-Type-Options: nosniff and Cache-Control: no-store. It never redirects to storage. Anyone who can see the project can download it.

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

dailybot plan project attachment get 00000000-0000-4000-8000-000000000001 00000000-0000-4000-8000-000000000009 -o ./plan.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.

List a milestone's attachments

The milestone's READY attachments, ordered by position. Anyone who can see the project can list them; a project 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. Reference it from the milestone description with an attachment:{uuid} marker; resolve it with GET /v1/plan/attachments/resolve/ when you render.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/milestones/00000000-0000-4000-8000-000000000007/attachments/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000009",
      "filename": "roadmap.png",
      "content_type": "image/png",
      "size": 48213,
      "url": "https://your.app/files/roadmap.png",
      "thumbnail_url": null,
      "width": null,
      "height": null,
      "status": "ready",
      "uploaded_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "executed_by_agent": null,
      "created_at": "2026-09-29T10:14:02Z"
    }
  ]
}

• 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 milestone attachment

One attachment of the milestone. Anyone who can see the project can read it.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/milestones/00000000-0000-4000-8000-000000000007/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "uuid": "00000000-0000-4000-8000-000000000009",
  "filename": "roadmap.png",
  "content_type": "image/png",
  "size": 48213,
  "url": "https://your.app/files/roadmap.png",
  "thumbnail_url": null,
  "width": null,
  "height": null,
  "status": "ready",
  "uploaded_by": {
    "kind": "user",
    "uuid": "00000000-0000-4000-8000-00000000000c",
    "name": "Ada L."
  },
  "executed_by_agent": null,
  "created_at": "2026-09-29T10:14:02Z"
}

• 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 milestone attachment's bytes

Streams the file with the content type recorded at upload, X-Content-Type-Options: nosniff and Cache-Control: no-store. It never redirects to storage. Anyone who can see the project can download it.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/milestones/00000000-0000-4000-8000-000000000007/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" -o roadmap.png

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

Get a project update

One status note, with its READY attachments inline, provenance, edited_at (null until the first edit) and executed_by_agent.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "uuid": "00000000-0000-4000-8000-00000000000a",
  "project": "00000000-0000-4000-8000-000000000001",
  "body": "Staging is green; rolling out Friday.",
  "body_html": "<p>Staging is green; rolling out Friday.</p>",
  "mentions": [],
  "health": "on_track",
  "created_by": {
    "kind": "user",
    "uuid": "00000000-0000-4000-8000-00000000000c",
    "name": "Ada L."
  },
  "executed_by_agent": null,
  "provenance": "typed",
  "edited_at": null,
  "attachments": [],
  "created_at": "2026-09-29T10:14:02Z",
  "updated_at": "2026-09-29T10:14:02Z"
}

• 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 update's attachments

The update's READY attachments, ordered by position. Anyone who can see the project can list them; a project 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. Reference it from the update body with an attachment:{uuid} marker; resolve it with GET /v1/plan/attachments/resolve/ when you render.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/attachments/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000009",
      "filename": "roadmap.png",
      "content_type": "image/png",
      "size": 48213,
      "url": "https://your.app/files/roadmap.png",
      "thumbnail_url": null,
      "width": null,
      "height": null,
      "status": "ready",
      "uploaded_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "executed_by_agent": null,
      "created_at": "2026-09-29T10:14:02Z"
    }
  ]
}

• 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 update attachment

One attachment of the update. Anyone who can see the project can read it.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "uuid": "00000000-0000-4000-8000-000000000009",
  "filename": "roadmap.png",
  "content_type": "image/png",
  "size": 48213,
  "url": "https://your.app/files/roadmap.png",
  "thumbnail_url": null,
  "width": null,
  "height": null,
  "status": "ready",
  "uploaded_by": {
    "kind": "user",
    "uuid": "00000000-0000-4000-8000-00000000000c",
    "name": "Ada L."
  },
  "executed_by_agent": null,
  "created_at": "2026-09-29T10:14:02Z"
}

• 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 update attachment's bytes

Streams the file with the content type recorded at upload, X-Content-Type-Options: nosniff and Cache-Control: no-store. It never redirects to storage. Anyone who can see the project can download it.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" -o roadmap.png

• 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 who reacted to a project update

Everyone who reacted to the update, oldest first, as a page. emoji narrows to one emoji. The same shape as a comment's reactor list.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000003/updates/00000000-0000-4000-8000-000000000007/reactions/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan project update reactions 00000000-0000-4000-8000-000000000003 00000000-0000-4000-8000-000000000007

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