`GET /api/commands/options/{provider_id}?q=` — resolve a named `OptionProvider` (`recent_tasks` / `models` / `efforts` / `projects` / `agents` / …) against the caller's tenancy, filtered by `q`. An unregistered provider id is a 404.

GET

/api/commands/options/{provider_id}

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

Authorizations

• cookie_auth

Parameters

Path Parameters

provider_id

required

string

Registered OptionProvider id

Query Parameters

q

string

Free-text filter (case-insensitive substring). Empty / absent = unfiltered.

model

string

The selected model id a model-aware provider keys its listing off (the effort_levels provider offers that model’s harness-native effort ladder, else the abstract 5-step). Absent = a tenancy-only lookup; other providers ignore it.

Responses

200

Media typeapplication/json

Array<object>

A selectable option for a parameter (ADR §2.2 Choice). Wire mirror of [crate::services::command_registry::options::Choice].

object

glyph

string | null

hint

string | null

label

required

string

value

required

string

Example^generated

[
  {
    "glyph": "example",
    "hint": "example",
    "label": "example",
    "value": "example"
  }
]

401

Authentication required

403

Permission denied

404

No such option provider

500

Structured server error