Minctrl Docs

List kanban tickets

GET
/kanban/tickets

List tickets visible to the caller (ADR-005 P4 hybrid visibility).

Requires a valid bearer token and an active company (403 otherwise). A given project_id is access-checked against the caller's company (403 on cross-company access); without it, tickets are scoped to the company.

Query params: • project_id — limit to one project; otherwise all projects in the caller's company • scope: - all (default) — every ticket in scope (capability: ticket.read.all → managers and above always; for members the UI flips this to "my" by default) - my — only tickets where assignee_user_id == self - claimable — unassigned tickets where required_role is set and caller's role meets the requirement (used by the review/approval queue in P5)

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

project_id?string|null
scope?Scope
Match^(all|my|claimable)$
Default"all"

Response Body

application/json

application/json

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