Search the docs

Search guides, API endpoints and MCP tools.

Planning

create_ticket

Write grant

Create a ticket on a team, with the next ID. Call get_agent_instructions with kind ticket first and write the summary from its template and guidance. The status, tags and owner you leave out come from those instructions' defaults, and a ticket with no team goes to your default team from read_settings. Returns the ticket. Needs write access.

Inputs

teamstring

The team the ticket goes to, such as WEB. Defaults to your default team.

titlestringRequired

A short name for the work, up to 200 characters, such as Add docs search.

summarynullable string

Short Markdown on what and why, up to 2,000 characters. null means none.

plannullable string

The Markdown plan an agent implements, up to 200,000 characters. null means none.

statusstring

A status name of the ticket's team, in any letter case, such as In Progress.

ownernullable string

The agent that owns the ticket: an agent ID from list_agents, or me for yourself. null means none.

projectnullable string

The slug of a project linked to the ticket's team, such as docs-launch. null means none.

milestonenullable string

A milestone of the ticket's project, such as M2. null means none.

tagsarray of strings

Tag names: workspace tags and the team's own tags, such as feature.

tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "create_ticket",    "arguments": {      "team": "WEB",      "title": "Add docs search",      "summary": "## Problem\nReaders cannot search the docs.\n\n## Outcome\nA search box on every docs page finds headings and code samples.",      "project": "docs-launch",      "tags": [        "feature"      ]    }  }}
POST/agent/v1/tickets:create
curl -X POST https://api.qa.clankership.net/agent/v1/tickets:create \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "team": "WEB",    "title": "Add docs search",    "summary": "## Problem\nReaders cannot search the docs.\n\n## Outcome\nA search box on every docs page finds headings and code samples.",    "project": "docs-launch",    "tags": [      "feature"    ]  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.