add_subtask
Create a sub-task under a work item (inherits its project; cycle/depth checked) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
Create a sub-task under a work item (inherits its project; cycle/depth checked).
| Required permission | work:write |
| Capability ID | workItems.addSubtask |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
title | string | no | |
quickAdd | string | no | |
description | string | no | |
statusId | string (uuid) | no | |
priority | URGENT | HIGH | MEDIUM | LOW | NONE | no | |
assigneeId | string (uuid) | no | |
labelIds | array of string (uuid) | no | |
estimateValue | number | no | |
startDate | string | no | |
endDate | string | no | |
dueDate | string | no | |
parentId | string (uuid) | yes |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"quickAdd": {
"type": "string",
"minLength": 1
},
"description": {
"type": "string"
},
"statusId": {
"type": "string",
"format": "uuid"
},
"priority": {
"type": "string",
"enum": [
"URGENT",
"HIGH",
"MEDIUM",
"LOW",
"NONE"
]
},
"assigneeId": {
"type": "string",
"format": "uuid"
},
"labelIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
}
},
"estimateValue": {
"type": "number"
},
"startDate": {
"type": "string",
"pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
},
"endDate": {
"type": "string",
"pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
},
"dueDate": {
"type": "string",
"pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
},
"parentId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"parentId"
],
"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.
add_project_member
Add a member to a project at a role (ADMIN/MEMBER/VIEWER) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).
archive_project
Archive or restore a project (hidden from default lists but retained) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).