Update a kanban ticket

Partially update a kanban ticket; may auto-trigger a workflow.

Requires a valid bearer token and an active company; the ticket's project must belong to the caller's company (403 otherwise). The caller must be an active member (403). ADR-005 P4: members/viewers may only update tickets assigned to them (403); managers and above may update any ticket in the company. Supplying expected_updated_at enables optimistic concurrency — a stale write returns 409, a malformed timestamp returns 422, and a missing ticket returns 404. Moving into a trigger column auto-starts an agent workflow.

Authorization

HTTPBearer

AuthorizationBearer <token>

In: header

Path Parameters

ticket_id*Ticket Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Partial update for a kanban ticket. Only supplied (non-null) fields change.

title?|

New ticket title.

description?|

New description.

column_id?|

UUID of the column to move the ticket into.

project_id?|

UUID of the project to move the ticket to.

priority?|

New priority.

order_index?|

New zero-based position within its column.

assigned_preset?|

New agent execution preset.

assigned_team?|

New agent team routing.

review_checkpoint?|

New review checkpoint/gate name.

expected_updated_at?|

Optimistic-concurrency token: the updated_at timestamp the client last saw (ISO-8601). When supplied, the update only applies if the row still matches; otherwise the API returns 409 instead of clobbering a concurrent change.

Response Body

`application/json`

curl -X PATCH "https://example.com/kanban/tickets/string" \  -H "Content-Type: application/json" \  -d '{    "column_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",    "expected_updated_at": "2026-07-01T12:00:00+00:00",    "priority": "high",    "title": "Add dark mode toggle"  }'

null

Empty