Sign in
Admin LLM

Create a model on an LLM connection

post/admin/llm/connections/{connectionId}/models

Request

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

Path parameters

connectionIdinteger required

Request body

brand'OPENAI' | 'ANTHROPIC' | 'GEMINI' | 'GEMMA' | 'META' | 'MISTRAL' | 'QWEN' | 'DEEPSEEK' | 'XAI' | 'COHERE' | 'Z_AI' | 'MOONSHOT'

Model brand declared by an admin; display only

contextWindowinteger

Context window in tokens

dataHandlingNotestring

Admin-only note: region, agreement, renewal date

displayNamestring required

Human-readable name

enabledboolean

Whether the model is active (default false)

maxOutputTokensinteger

Maximum output tokens

operatedBy'OWN_ORGANISATION' | 'PROVIDER'

Who operates the systems the work is sent to; omit to leave the model undeclared

reasoningEffort'NONE' | 'MINIMAL' | 'LOW' | 'MEDIUM' | 'HIGH' | 'XHIGH' | 'MAX'

Reasoning effort to request; null sends none, so the provider's own default applies

slugstring

Optional internal slug; generated from displayName when omitted

upstreamModelIdstring required

Upstream provider model id

Response

Model created; URL in the Location header

brand'OPENAI' | 'ANTHROPIC' | 'GEMINI' | 'GEMMA' | 'META' | 'MISTRAL' | 'QWEN' | 'DEEPSEEK' | 'XAI' | 'COHERE' | 'Z_AI' | 'MOONSHOT'

Model brand declared by an admin; display only

connectionDisplayNamestring required

Owning connection's display name

connectionIdinteger required

Owning connection id

contextWindowinteger

Context window in tokens

createdAtstring date-time required

Creation timestamp

dataHandlingNotestring

Admin-only note: region, agreement, renewal date

dataHandlingTier'IN_HOUSE' | 'CLOUD' | 'UNDECLARED' required

Data-handling tier derived from the operator; UNDECLARED until it is set

displayNamestring required

Human-readable name

enabledboolean required

Active toggle

grantedWorkspaceIdsinteger[] required

Workspace ids shared with; only meaningful when visibility is GRANTED

idinteger required

Model id

maxOutputTokensinteger

Maximum output tokens

operatedBy'OWN_ORGANISATION' | 'PROVIDER'

Who operates the systems the work is sent to; null until declared

reasoningEffort'NONE' | 'MINIMAL' | 'LOW' | 'MEDIUM' | 'HIGH' | 'XHIGH' | 'MAX'

Reasoning effort requested of the model; null sends none, the provider's default applies

slugstring required

Unique slug within the connection

updatedAtstring date-time

Last update timestamp

upstreamModelIdstring required

Upstream provider model id

visibility'PUBLIC' | 'GRANTED' required

Share with all workspaces (PUBLIC) or only selected ones (GRANTED)

Changes

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