Bottlenecks

Bottlenecks track blockers and obstacles that are slowing down progress on your projects. Identifying and prioritizing bottlenecks helps you focus on removing the biggest impediments first.

GET /api/v1/bottlenecks

List all bottlenecks for the authenticated user.

Response

[
  {
    "id": "clxb1c2d3...",
    "name": "Waiting on API credentials from vendor",
    "priority": "PRIORITY",
    "project_ids": ["clx4d5e6f..."],
    "createdAt": "2026-03-10T10:00:00.000Z",
    "updatedAt": "2026-03-20T10:00:00.000Z"
  }
]

POST /api/v1/bottlenecks

Create a new bottleneck.

Request Body

{
  "name": "Waiting on API credentials from vendor",
  "priority": "PRIORITY",
  "project_ids": ["clx4d5e6f..."]
}

Fields

Field	Type	Required	Description
`name`	`string`	Yes	Description of the bottleneck
`priority`	`string`	No	One of: `PRIORITY`, `Small Problem`, `Resolved`, `Archived`
`project_ids`	`string[]`	No	IDs of projects affected by this bottleneck

Response

Returns the created bottleneck object.

PATCH /api/v1/bottlenecks/:id

Update an existing bottleneck. Only include the fields you want to change.

Request Body

{
  "priority": "Resolved"
}

All fields from the create endpoint are accepted. Only provided fields will be updated.

Response

Returns the updated bottleneck object.

DELETE /api/v1/bottlenecks/:id

Permanently delete a bottleneck.

Response

{
  "success": true
}