Docs: Tool reference
planning toolset

save_view

Create or update a saved view. Saves a named view: scope (posts, users, companies, or roadmap with roadmap and group_by), filter, query (users and companies), sort and columns, private to you or shared with the workspace. Omit id to create; pass id to update. You change your own views; managers and owners also change shared ones. Filters are checked when saved. Nobody is emailed.

Toolset
planning
Who can call it
OwnersManagersContributorsAPI keys
REST
POST /api/v1/w/{workspace}/views
Behavior
changes dataidempotentaccepts idempotency_key

Input

FieldTypeDescription
idstringThe view's ID or name, to update it.
scopeone of: posts, users, companies, roadmap
namestring
filterobject or null
querystring or null
sortstring or null
columnsarray of stringColumns in order. posts: title, board, category, status, votes, comments, owner, eta, tags, author, created_at, updated_at, url, custom.<key>. users: name, email, external_id, companies, votes, posts, comments, last_active_at, created_at, attr.<key>. companies: name, external_id, mrr, renewal_date, renewal_risk, account_owner, user_count, created_at. voters (exports): post, name, email, companies, mrr, priority, note, voted_at. roadmap: title, status, board, category, owner, tags, votes, comments, mrr_at_stake, factors, impact, effort, score (factors = one column per scoring factor). Omit for sensible defaults.
sharingone of: private, workspace
roadmapstringRoadmap views: the roadmap's name or ID (set when creating).
group_byone of: status, owner, category, board, tag or nullRoadmap views: group items by this.
expected_versionintegerThe view's version from your last read; the call fails if it changed since.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
viewrequiredobject
createdrequiredboolean

Calling it

// MCP: tools/call
{ "name": "save_view", "arguments": {} }

// Typed client
await carechannel.save_view({});