Skip to main content
POST
List Agent Models Live

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for POST /agents/models/live.

Same two shapes as ValidateLlmRequest minus model - this endpoint lists every model the caller's credentials can see, it doesn't check a specific one. savedConnectionId bypasses the inline-apiKey requirement identically.

capability scopes which models the response should include:

  • chat — runs the chat-capable + tool-capable filters; returns each model with its per-(provider, model) tuning matrix attached, since the FE renders temperature / reasoning controls off that blob.
  • embedding — runs the embedding-capable filter; returns each model as {value, label} (no tuning matrix — embedding endpoints accept no temperature / reasoning controls).

A second validator rejects (provider, capability) pairs that contradict :data:PROVIDER_CAPABILITIES (e.g. provider=anthropic + capability=embedding) before the BE wastes a round-trip on a request the matrix already pinned as impossible.

provider
enum<string>
required

Unified LLM provider enum.

A single AgentLlmConnection row carries one provider and a set of capabilities (chat / embedding). PROVIDER_CAPABILITIES below pins which capabilities each provider can serve — picked by the FE Connections drawer and re-validated server-side on every write.

Available options:
anthropic,
openai,
openai-responses,
ollama,
azure,
azure-openai,
bedrock,
qwen,
openai-compatible
capability
enum<string>
required

Which model list the FE wants. chat filters to chat + tool-capable models; embedding filters to embedding-capable models. Must be in PROVIDER_CAPABILITIES[provider].

Available options:
chat,
embedding
apiKey
string
default:""

Raw key - never stored

Maximum string length: 512
baseUrl
string | null
Maximum string length: 512
savedConnectionId
string | null

If set, BE resolves provider/apiKey/baseUrl from the saved llmConnection by id.

Maximum string length: 100

Response

Successful Response

The response is of type Response Listagentmodelslive · object.