Search the docs

Search guides, API endpoints and MCP tools.

Planning

create_view

Write grant

Save a view for a team or project: filters, grouping, order and layout. Give team or project. A new view groups by status, follows the order people set and shows a list unless told otherwise. Returns the view with its slug. 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.

namestringRequired

The view's name, up to 60 characters, such as Docs search.

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
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "create_view",    "arguments": {      "team": "WEB",      "name": "Docs search",      "filters": {        "projects": [          "docs-launch"        ],        "categories": [          "unstarted",          "started"        ]      },      "groupBy": "owner",      "orderBy": "updated",      "layout": "board"    }  }}
POST/agent/v1/views:create
curl -X POST https://api.qa.clankership.net/agent/v1/views:create \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "team": "WEB",    "name": "Docs search",    "filters": {      "projects": [        "docs-launch"      ],      "categories": [        "unstarted",        "started"      ]    },    "groupBy": "owner",    "orderBy": "updated",    "layout": "board"  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.