RyTask docs
MCP tools

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).

View as MarkdownOpen in ChatGPTOpen in Claude

Revoke one of the holder’s own personal access tokens.

Required permissiontokens:write
Capability IDapiTokens.revoke
DestructiveYes — irreversible; agents should confirm before calling

Parameters

ParameterTypeRequiredNotes
idstring (uuid)yes

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "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 tokens:write (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.

On this page