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.

Inputs

teamstring

The team the view belongs to, such as WEB. Give team or project, not both.

projectstring

The project the view belongs to, such as docs-launch. Give team or project, not both.

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, tag, project or none; project views by status, category, owner, tag, milestone, team or none.

One ofstatuscategoryownertagprojectmilestoneteamnone
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 or a board.

One oflistboard
isDefaultboolean

true makes this the view the team's or project's Tickets page opens.

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/agent/v1/views:update
curl -X POST https://api.qa.clankership.net/agent/v1/views:update \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "team": "WEB",    "view": "docs-search",    "layout": "list",    "isDefault": true  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.