---
title: "Describe one command: toolset, tier, read or write, scopes and whether this credential holds them, description, input and output schemas, annotations, examples, aliases, availability, and how to run it on REST, the CLI and MCP"
method: GET
path: "/v1/commands/{name}"
---

# Describe one command: toolset, tier, read or write, scopes and whether this credential holds them, description, input and output schemas, annotations, examples, aliases, availability, and how to run it on REST, the CLI and MCP

`GET /v1/commands/{name}`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/{name}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Describe one command: toolset, tier, read or write, scopes and whether this credential holds them, description, input and output schemas, annotations, examples, aliases, availability, and how to run it on REST, the CLI and MCP. A retired name resolves to its canonical command and the response says so. Unknown names answer 404 TOOL_NOT_FOUND with a next hint.

## Path parameters

- `name` string, required

## Headers

- `X-Workspace-ID` string

## Response `200`

Describe one command: toolset, tier, read or write, scopes and whether this credential holds them, description, input and output schemas, annotations, examples, aliases, availability, and how to run it on REST, the CLI and MCP. A retired name resolves to its canonical command and the response says so. Unknown names answer 404 TOOL_NOT_FOUND with a next hint.

- CommandDescription
  - `name` string, required
  - `toolset` string, required
  - `tier` 'core' | 'deferred', required
  - `scopes` string[], required
  - `aliases` string[]
  - `confirm` string
  - `scopeAuthorized` boolean, required
  - `readOnly` boolean, required
  - `description` string, required
  - `requestedAs` string
  - `note` string
  - `availability` 'unavailable'
  - `inputSchema` object, required: JSON Schema contract.
  - `outputSchema` object, required: JSON Schema contract.
  - `annotations` object, required
    - `readOnlyHint` boolean
    - `destructiveHint` boolean
    - `idempotentHint` boolean
    - `openWorldHint` boolean
  - `examples` unknown[]
    - unknown
  - `runWith` object, required
    - `rest` string, required
    - `cli` string, required
    - `mcp` string, required

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/2a712a1dcfa7?raw)