Minctrl Docs

Claim a review ticket

POST
/kanban/tickets/{ticket_id}/claim

Self-assign a claimable review ticket (ADR-005 §D7, P5).

Requires a valid bearer token and an active company; the ticket's project must belong to the caller's company (403). The caller must be an active member (403), meet the ticket's required_role if set (403), and the ticket must be unassigned (409 if already claimed, 404 if it does not exist).

Used when a manager picks up a gate-pause ticket from the ?scope=claimable queue. Sets assignee_user_id = self only if: • caller is an active member of the ticket's company • caller's role meets the ticket's required_role • ticket is currently unassigned (avoid stealing)

The ticket stays in the "Awaiting Review" column — the column move happens later when the workflow resumes via /reviews/decision or /workflows/{id}/gate/approve.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

ticket_id*Ticket Id

Response Body

application/json

application/json

curl -X POST "https://example.com/kanban/tickets/string/claim"
null
Empty
Empty
Empty
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}