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
| Field | Type | Description |
|---|---|---|
id | string | The view's ID or name, to update it. |
scope | one of: posts, users, companies, roadmap | |
name | string | |
filter | object or null | |
query | string or null | |
sort | string or null | |
columns | array of string | Columns 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. |
sharing | one of: private, workspace | |
roadmap | string | Roadmap views: the roadmap's name or ID (set when creating). |
group_by | one of: status, owner, category, board, tag or null | Roadmap views: group items by this. |
expected_version | integer | The view's version from your last read; the call fails if it changed since. |
idempotency_key | string | Retry-safe key. Repeating a call with the same key returns the first result. |
Output
| Field | Type | Description |
|---|---|---|
viewrequired | object | |
createdrequired | boolean |
Calling it
// MCP: tools/call
{ "name": "save_view", "arguments": {} }
// Typed client
await carechannel.save_view({});