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

Authorization

AuthorizationBearer token · headerrequired

Request body

requiredapplication/json

providerAgentLlmProviderEnumrequired

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.

Allowed:anthropicopenaiopenai-responsesollamaazureazure-openaibedrockqwenopenai-compatible

capabilityConnectionCapabilityrequired

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.

Allowed:chatembedding

apiKeystring

Raw key - never stored

max length 512 · default: ""

baseUrlstring | null

Show properties

Any of:

string

string

null

null

savedConnectionIdstring | null

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

Show properties

Any of:

string

string

null

null

Responses

200

Successful Response

object

422

Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X POST 'https://api.streamkap.com/agents/models/live' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "provider": "anthropic",
  "capability": "chat",
  "apiKey": "",
  "baseUrl": "string",
  "savedConnectionId": "string"
}'

const response = await fetch("https://api.streamkap.com/agents/models/live", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"provider\": \"anthropic\",\n  \"capability\": \"chat\",\n  \"apiKey\": \"\",\n  \"baseUrl\": \"string\",\n  \"savedConnectionId\": \"string\"\n}"
});

import requests

response = requests.post(
    "https://api.streamkap.com/agents/models/live",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"provider\": \"anthropic\",\n  \"capability\": \"chat\",\n  \"apiKey\": \"\",\n  \"baseUrl\": \"string\",\n  \"savedConnectionId\": \"string\"\n}",
)

Response

{}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}