v3

latestOpenAPI 3.1.0Proprietary2026-08-07266348629.6 KB
Agents

List Agent Models Live

Return the provider's live model list using the caller's API key.

The key is forwarded directly to the provider's /v1/models endpoint (or Ollama's /api/tags) and not persisted. Response shape matches GET /agents/models per provider so the FE can swap the static fallback for the live list without changing the dropdown contract.

422 if apiKey is missing for a non-Ollama provider. 400 with the provider's own error message on invalid key / connection failure. Per-tenant rate limit: 30 req/min/bucket -> 429 with Retry-After.

post/agents/models/live

Request body

provider'anthropic' | 'openai' | 'openai-responses' | 'ollama' | 'azure' | 'azure-openai' | 'bedrock' | 'qwen' | 'openai-compatible' 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.

capability'chat' | 'embedding' required

What a saved LLM connection can power.

chat covers agent runtime + system-prompt suggestion + test-run. embedding covers knowledge-base embedding generation.

A single connection can carry both when the provider supports both (OpenAI / Azure / Ollama) — one saved credential, two capabilities.

apiKeystring

Raw key - never stored

baseUrlstring nullable
savedConnectionIdstring nullable

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

Response

Successful Response

object required