Projects API

List my projects

GET /api/v1/projects

Returns only projects the authenticated user has any role in.

Create

POST /api/v1/projects

Role: org-level admin (any owner of any project, or the first admin). Body:

{ "name": "billing-prod" }

Response includes the new project_id and makes the caller owner.

Get

GET /api/v1/projects/{id}

Returns project metadata and your role in it.

Update

PATCH /api/v1/projects/{id}

Role: owner. Can change name and project-scoped settings.

Delete

DELETE /api/v1/projects/{id}?confirm=<name>

Role: owner. Destructive. The confirm query must match the project name verbatim - prevents click-through accidents.

Effect: cascades agents, tasks, events, memberships. Preserves audit log (with project_id retained for traceability).

Project-scoped settings

• task_retention_days - default 90. Set per-project.
• redaction_overrides - optional list of additional redaction patterns.
• timezone - for display in the dashboard. Defaults to UTC.