API reference

Fetch model catalogs before choosing a model.

Ask the API for current models and for the models allowed by a configured agent. Treat the choice as part of your product evidence loop.

Endpoints

GET /v1/models returns the global model catalog keyed by backend.
GET /v1/harnesses/{id}/models returns the model set allowed for one configured agent.

Backend map

GET /v1/models is keyed by backend. The base harness claude-code corresponds to backend key claude; other base harnesses generally use the same key as the base name.

Model catalog shape

{
  "backends": {
    "codex": { "default": "<id>", "models": [] },
    "claude": { "default": "<id>", "models": [] },
    "hermes": { "default": "<id>", "models": [] }
  }
}