Search the docs

Search guides, API endpoints and MCP tools.

Planning

update_view

Write grantIdempotent

Change a view for everyone, or make it the default. Only the settings given change; filters replace the view's filters, and a new name gives a new slug. Returns the view. Needs write access, and your person must be in the view's team or one of its project's teams, or be a workspace owner or admin. Your person's own views are theirs alone, whatever their role.

Inputs

teamstring

The team the view belongs to, such as WEB. Give one of team, project or mine.

projectstring

The project the view belongs to, such as docs-launch. Give one of team, project or mine.

mineboolean

Your person's own views, the tabs of their My work, when true. Give one of team, project or mine.

Always true
viewstringRequired

A view's slug, such as active.

namestring

A new name, up to 60 characters.

filtersobject

Which tickets the view shows. Filters combine with and; the values within one filter with or.

groupBystring

How to group tickets. Team views group by status, category, owner, clanker, tag, project or none; project views by status, category, owner, clanker, tag, milestone, team or none. A ticket with several clankers shows under each.

One ofstatuscategoryownerclankertagprojectmilestoneteamnone
orderBystring

How to order tickets: manual follows the order people set, created puts the newest first, updated puts the most recently changed first.

One ofmanualcreatedupdated
layoutstring

Show the tickets as a list, a board, or the work layout.

One oflistboardwork
isDefaultboolean

true makes this the view the owner's page opens: Tickets, or My work.

Always true
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "update_view",    "arguments": {      "team": "WEB",      "view": "docs-search",      "layout": "list",      "isDefault": true    }  }}
POST/clanker/v1/views:update
curl -X POST https://api.clankership.com/clanker/v1/views:update \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "team": "WEB",    "view": "docs-search",    "layout": "list",    "isDefault": true  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.