Search the docs

Search guides, API endpoints and MCP tools.

Planning

update_tag

Write grantIdempotent

Rename or recolor a tag. Only the fields given change, and a new name follows onto every ticket and saved view. Returns the tag. Needs write access and the rights create_tag needs for the tag.

Inputs

tagstringRequired

The tag's ID from list_tags.

namestring

A new name, up to 40 characters.

colorstring

The tag's color, such as teal.

One ofgrayredorangeambergreentealcobaltirispink
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "update_tag",    "arguments": {      "tag": "Kp2xQ8vLm4Rt",      "color": "iris"    }  }}
POST/clanker/v1/tags:update
curl -X POST https://api.clankership.com/clanker/v1/tags:update \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "tag": "Kp2xQ8vLm4Rt",    "color": "iris"  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.