Search the docs

Search guides, API endpoints and MCP tools.

Planning

create_tag

Write grant

Create a workspace tag, or a team's own tag with team. A workspace tag cannot share a name with a team tag. Returns the tag. Needs write access; a workspace tag needs your person to be a workspace owner or admin, and a team tag needs them in the team.

Inputs

namestringRequired

The tag's name, up to 40 characters, such as search.

colorstringRequired

The tag's color, such as teal.

One ofgrayredorangeambergreentealcobaltirispink
teamstring

The team the tag belongs to, such as WEB.

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