STstreamkap
Agents

List Agent Models Live

Changed on

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 a client can replace the curated list with the live one without other changes. hiddenNoTools counts the chat models omitted because they do not support tool calling.

422 if apiKey is missing for a non-Ollama provider and no savedConnectionId is given. 404 if savedConnectionId does not match a saved connection. 400 with the provider's own error message on invalid key / connection failure. Per-tenant rate limit: 30 req/min -> 429 with Retry-After.

post/agents/models/live

Request

Request body

provider'anthropic' | 'openai' | 'openai-responses' | 'ollama' | 'azure' | 'azure-openai' | 'bedrock' | 'qwen' | 'openai-compatible' required

Unified LLM provider enum.

A single AgentLlmConnection carries one provider and a set of capabilities (chat / embedding). Each provider supports a fixed set of capabilities, validated 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, Streamkap uses the provider, apiKey and baseUrl of the saved LLM connection with this id.

Response

Successful Response

object required

Changes