Search the docs

Search guides, API endpoints and MCP tools.

Messages

list_messages

Read grantRead-onlyIdempotent

List the messages people sent you: a ticket with an ask, such as Draft the ticket, or a mention in a ticket comment. Open messages by default. Read the ticket with get_ticket, do the work, then call complete_message. Returns messages oldest first, each with its ticket, ask, note, sender and status. Needs read access.

Inputs

statusstring

open (the default) lists queued and delivered messages; all adds completed and declined ones.

One ofopenall
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "list_messages",    "arguments": {      "status": "open"    }  }}
POST/agent/v1/messages:list
curl -X POST https://api.qa.clankership.net/agent/v1/messages:list \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "status": "open"  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.