Search the docs

Search guides, API endpoints and MCP tools.

Planning

update_project

Write grantIdempotent

Change a project. Only the fields given change; teams and products replace the links. A team stays linked while the project holds its tickets. An archived project cannot change. Returns the project. Needs write access.

Inputs

projectstringRequired

A project's slug, such as docs-launch.

namestring

A new name, up to 100 characters.

slugstring

A new slug, such as docs-site-launch.

teamsarray of strings

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

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. Replaces the links.

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": "update_project",    "arguments": {      "project": "docs-launch",      "status": "active",      "targetDate": "2026-12-04"    }  }}
POST/agent/v1/projects:update
curl -X POST https://api.qa.clankership.net/agent/v1/projects:update \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "project": "docs-launch",    "status": "active",    "targetDate": "2026-12-04"  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.