Sign in
Admin LLM

Create an LLM connection

post/admin/llm/connections

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /admin/llm/connections
  • Auth: HTTP bearer

Request body

apiKeystring

API key (write-only; never returned)

apiProtocolstring required

Wire protocol

authMode'BEARER' | 'API_KEY'

Credential shape (default BEARER)

baseUrlstring required

Provider base URL

connectionPlatform'LOGOS' | 'VLLM' | 'OLLAMA' | 'AZURE' | 'AWS_BEDROCK' | 'GOOGLE_VERTEX' | 'OPENAI' | 'GOOGLE_AI_STUDIO' | 'ALIBABA_CLOUD' | 'GROQ' | 'FIREWORKS' | 'TOGETHER_AI' | 'DEEPINFRA' | 'NEBIUS' | 'OPENROUTER' | 'CLOUDFLARE_AI_GATEWAY' | 'VERCEL_AI_GATEWAY'

Admin-declared connection platform; null when not declared

displayNamestring required

Human-readable name

enabledboolean

Whether the connection is enabled (default false)

slugstring

Optional internal slug; generated from displayName when omitted

Example request

{
  "apiProtocol": "openai-responses"
}

Response

Connection created; URL in the Location header

apiKeyLast4string

Last four characters of the stored API key, if any

apiProtocolstring required

Wire protocol

authMode'BEARER' | 'API_KEY' required

Credential shape

baseUrlstring required

Provider base URL

connectionPlatform'LOGOS' | 'VLLM' | 'OLLAMA' | 'AZURE' | 'AWS_BEDROCK' | 'GOOGLE_VERTEX' | 'OPENAI' | 'GOOGLE_AI_STUDIO' | 'ALIBABA_CLOUD' | 'GROQ' | 'FIREWORKS' | 'TOGETHER_AI' | 'DEEPINFRA' | 'NEBIUS' | 'OPENROUTER' | 'CLOUDFLARE_AI_GATEWAY' | 'VERCEL_AI_GATEWAY'

Admin-declared connection platform

createdAtstring date-time required

Creation timestamp

displayNamestring required

Human-readable name

enabledboolean required

Whether the connection is enabled

hasApiKeyboolean required

Whether an API key is stored

idinteger required

Connection ID

slugstring required

Unique slug

updatedAtstring date-time

Last update timestamp

Example response

{
  "apiProtocol": "openai-responses",
  "slug": "openai-prod"
}

Changes

No recorded changes to this operation across all 1 revision of this API.