Search the docs

Search guides, API endpoints and MCP tools.

Planning

create_project

Write grant

Create a project for one or more teams; only those teams' tickets can join it. It goes last in priority order and gets the default views. Returns the project. Needs write access.

Inputs

namestringRequired

The project's name, up to 100 characters, such as Docs launch.

slugstringRequired

The project's slug: 2 to 48 lowercase letters, numbers or hyphens, such as docs-launch.

teamsarray of stringsRequired

Keys of the teams whose tickets the project holds, such as WEB.

At least 1 item
summarynullable string

Up to 200 characters on what the project delivers. null means none.

statusstring

Where the project stands. A new project starts planned.

One ofplannedactivepausedcompletedcanceled
leadnullable string

The project lead's email or user ID, such as maya@acme.dev. null means none.

targetDatenullable string

The target date as YYYY-MM-DD, such as 2026-11-30. null means none.

productsarray of strings

Slugs of the products the project changes, such as storefront.

documentnullable string

The project's Markdown document, up to 200,000 characters. null means none.

tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "create_project",    "arguments": {      "name": "Docs launch",      "slug": "docs-launch",      "teams": [        "WEB"      ],      "summary": "Ship the public docs site with search.",      "status": "active",      "lead": "maya@acme.dev",      "targetDate": "2026-11-30",      "products": [        "storefront"      ]    }  }}
POST/agent/v1/projects:create
curl -X POST https://api.qa.clankership.net/agent/v1/projects:create \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "name": "Docs launch",    "slug": "docs-launch",    "teams": [      "WEB"    ],    "summary": "Ship the public docs site with search.",    "status": "active",    "lead": "maya@acme.dev",    "targetDate": "2026-11-30",    "products": [      "storefront"    ]  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.