`GET /api/commands` — the seeded command registry filtered to the commands the caller's identity (workspace + role) can run. A new SurfaceDriver reads this list to build its command palette; it will never contain a command the caller can't invoke.

GET

/api/commands

const url = 'https://example.com/api/commands';
const options = {method: 'GET', headers: {cookie: 'supacloud_session=<supacloud_session>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/commands \
  --cookie supacloud_session=<supacloud_session>

Authorizations

cookie_auth

Responses

200

application/json

Array<object>

A command descriptor (ADR §2.2 CommandDescriptor) on the wire. The body item of GET /api/commands.

object

aliases

required

Array<string>

category

required

string

description_i18n

required

string

params

required

Array<object>

One typed command parameter (ADR §2.2 ParamSpec). description_i18n is the i18n KEY a client resolves to its own locale.

object

description_i18n

required

string

kind

required

One of:

object

type

required

string

Allowed values: enum

name

required

string

options

required

One of:

A static, closed value set known at compile time.

object

source

required

string

Allowed values: static

values

required

Array<string>

Resolved at runtime by the named option provider (GET /options/{id}).

object

provider_id

required

string

source

required

string

Allowed values: dynamic

required

required

boolean

scope

required

task | project | workspace | global.

string

surfaces

required

The surfaces the command is available on (web_cli | telegram | discord | api).

Array<string>

word

required

string

Example

[
  {
    "params": [
      {
        "kind": {
          "type": "enum"
        },
        "options": {
          "source": "static"
        }
      }
    ]
  }
]

401

Authentication required

403

Permission denied

500

Structured server error