Admin LLM

Update a model's metadata

patch/admin/llm/models/{id}

Request

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

Path parameters

idinteger required

Request body

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

Model brand declared by an admin; null keeps current

clearBrandboolean

Clear the declared model brand

clearReasoningEffortboolean

True clears the reasoning effort, so the provider's own default applies

contextWindowinteger

Context window in tokens

dataHandlingNotestring

Admin-only note: region, agreement, renewal date

displayNamestring

Human-readable name

enabledboolean

Active toggle (off = existing settings stop working)

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 keeps the current one (see clearReasoningEffort)

Response

OK

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 50 revisions of this API.