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 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

Authorization

AuthorizationBearer token · headerrequired

Request body

requiredapplication/json

providerAgentLlmProviderEnumrequired

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.

Allowed:anthropicopenaiopenai-responsesollamaazureazure-openaibedrockqwenopenai-compatible

capabilityConnectionCapabilityrequired

Which model list to return. chat filters to chat + tool-capable models; embedding filters to embedding-capable models. Must be a capability the provider supports.

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, Streamkap uses the provider, apiKey and baseUrl of the saved LLM connection with this 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 'Accept: application/json' \
  -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",
    "Accept": "application/json",
    "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",
        "Accept": "application/json",
        "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": {}
    }
  ]
}