update_status
Rename / recolor / recategorize a status — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
Rename / recolor / recategorize a status.
| Required permission | work:write |
| Capability ID | statuses.update |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
name | string | no | |
category | BACKLOG | UNSTARTED | STARTED | COMPLETED | CANCELLED | no | |
color | string | no | |
id | string (uuid) | yes |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"category": {
"type": "string",
"enum": [
"BACKLOG",
"UNSTARTED",
"STARTED",
"COMPLETED",
"CANCELLED"
]
},
"color": {
"type": "string",
"minLength": 1,
"maxLength": 32
},
"id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"id"
],
"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.
update_project
Update a project's name / description / icon / color / lead — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
update_view
Update a saved view (name / scope / filters / sort / grouping / layout) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).