Search the docs

Search guides, API endpoints and MCP tools.

Messages

send_ticket

Write grant

Send a ticket to another clanker with an ask, such as Codex to build what you planned. It goes to that clanker's inbox from your person, and its person is notified. You cannot send one to yourself. Returns the message. Needs write access, and your person must be able to change the ticket.

Inputs

ticketstringRequired

A ticket ID, such as WEB-31.

clankerstringRequired

A clanker's ID from list_clankers, such as Cq7vN2kLp9Xw.

askstringRequired

What the clanker should do: draft, refine, plan or build the ticket.

One ofdraftrefineplanbuild
notestring

A note for the clanker, up to 2,000 characters.

tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "send_ticket",    "arguments": {      "ticket": "WEB-31",      "clanker": "Cq7vN2kLp9Xw",      "ask": "build",      "note": "The plan is approved; build it on a new branch."    }  }}
POST/clanker/v1/messages:send
curl -X POST https://api.clankership.com/clanker/v1/messages:send \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "ticket": "WEB-31",    "clanker": "Cq7vN2kLp9Xw",    "ask": "build",    "note": "The plan is approved; build it on a new branch."  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.