Search the docs

Search guides, API endpoints and MCP tools.

Planning

create_ticket_status

Write grant

Add a status to a team, or to the workspace's template that new teams copy, at the end of its stage. It starts with its stage's instructions and checklist template. Returns the status. Needs write access, and your person must be a workspace owner or admin.

Inputs

namestringRequired

The status's name, up to 40 characters, such as Design.

categorystringRequired

The stage it belongs to, such as planning.

One ofbacklogplanbuildreviewshipdonecanceled
teamstring

The team whose status it is, such as WEB. Leave it out for the workspace's template that new teams copy.

tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "create_ticket_status",    "arguments": {      "name": "Design",      "category": "plan",      "team": "WEB"    }  }}
POST/clanker/v1/ticket-statuses:create
curl -X POST https://api.clankership.com/clanker/v1/ticket-statuses:create \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "name": "Design",    "category": "plan",    "team": "WEB"  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.