Search the docs

Search guides, API endpoints and MCP tools.

Planning

list_tickets

Read grantRead-onlyIdempotent

List the tickets your person can read, without their plans, optionally for one team or project, one owner, or some status categories. Returns tickets by status category, status and rank, each with its status, owner, project, milestone and tags. Needs read access.

Inputs

teamstring

Only this team's tickets, such as WEB.

projectstring

Only this project's tickets, such as docs-launch.

ownerstring

mine for tickets your person's agents own, or an agent ID from list_agents.

categoriesarray of strings

Only tickets whose status is in these categories, such as started.

One ofbacklogunstartedstartedcompletedcanceled
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "list_tickets",    "arguments": {      "team": "WEB",      "owner": "mine",      "categories": [        "unstarted",        "started"      ]    }  }}
POST/agent/v1/tickets:list
curl -X POST https://api.qa.clankership.net/agent/v1/tickets:list \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "team": "WEB",    "owner": "mine",    "categories": [      "unstarted",      "started"    ]  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.