save_view
Save a view (filter AST + sort + grouping + layout; personal or shared) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
Save a view (filter AST + sort + grouping + layout; personal or shared).
| Required permission | work:write |
| Capability ID | views.save |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
name | string | yes | |
kind | BOARD | LIST | yes | |
scope | PERSONAL | SHARED | no | |
projectId | string (uuid) | null | no | |
filters | object | no | |
grouping | object | null | no | |
sort | array of object | no | |
layout | object | null | no |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"kind": {
"type": "string",
"enum": [
"BOARD",
"LIST"
]
},
"scope": {
"type": "string",
"enum": [
"PERSONAL",
"SHARED"
],
"default": "PERSONAL"
},
"projectId": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"filters": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"description": "recursive — same shape as the parent node"
}
},
{
"type": "object",
"additionalProperties": {
"description": "recursive — same shape as the parent node"
}
}
]
}
},
"grouping": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"description": "recursive — same shape as the parent node"
}
},
{
"type": "object",
"additionalProperties": {
"description": "recursive — same shape as the parent node"
}
}
]
}
},
{
"type": "null"
}
]
},
"sort": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"description": "recursive — same shape as the parent node"
}
},
{
"type": "object",
"additionalProperties": {
"description": "recursive — same shape as the parent node"
}
}
]
}
}
},
"layout": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"description": "recursive — same shape as the parent node"
}
},
{
"type": "object",
"additionalProperties": {
"description": "recursive — same shape as the parent node"
}
}
]
}
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"kind"
],
"additionalProperties": false
}Access control
A call succeeds only when the personal access token's scopes and the holder's role both allow work:write (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.
revoke_api_token
Revoke one of the holder’s own personal access tokens — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the tokens:write permission).
search
Full-text search across work items, comments, projects, labels, and users (ranked, permission-scoped) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:read permission).