RyTask docs
MCP tools

create_label

Create a workspace label — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).

View as MarkdownOpen in ChatGPTOpen in Claude

Create a workspace label.

Required permissionwork:write
Capability IDlabels.create
DestructiveNo

Parameters

ParameterTypeRequiredNotes
namestringyes
colorstringno

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "color": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    }
  },
  "required": [
    "name"
  ],
  "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.

On this page