Skip to main content
PUT
update llm

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

The LLM ID

Body

application/json

Partial LLM update; fields left out keep their values. Default LLMs (not your organization's) can't be changed. A new secret replaces the stored one. urls replaces the whole list, and adding a URL the LLM didn't have needs the top-level secret in the same request (a per-URL urls[].secret isn't enough), or it is refused with 400.

displayName
string
description
string
urls
object[]
Minimum array length: 1
llmFormat
enum<string>
Available options:
openai,
azure_openai,
groq_openai,
gemini,
none
modelName
string
deploymentName
string
apiVersion
string
temperature
number | null
Required range: 0 <= x <= 2
maxTokens
integer
Required range: x >= 1
secret
string
metadata
object
reasoningEffort
string | null

Reasoning effort for models that take it, sent to the provider as is, such as low, medium or high (values depend on the model). Set null to clear it and use the model default.

Maximum string length: 50
Example:

"minimal"

reasoningFormat
enum<string> | null

Groq reasoning format hint. Set null to clear and use the model default.

Available options:
parsed,
hidden,
null

Response

Successfully updated LLM

An LLM configuration a persona can use. Secrets are never returned.

id
string<uuid>

Unique identifier for the LLM configuration.

displayName
string

Human-readable name shown in the Lab.

description
string | null

Free-form description of the LLM configuration.

llmFormat
enum<string>

Wire format used to call the upstream LLM.

Available options:
openai,
azure_openai,
groq_openai,
gemini,
none
urls
object[]

Endpoints configured for this LLM. Omitted for Anam's global LLMs.

modelName
string | null

Upstream model identifier (e.g. gpt-4o).

temperature
number | null

Sampling temperature applied when calling the LLM.

maxTokens
integer | null

Maximum tokens generated per response.

deploymentName
string | null

Azure OpenAI deployment name. Only used when llmFormat is azure_openai; omitted for Anam's global LLMs.

apiVersion
string | null

Azure OpenAI API version. Only used when llmFormat is azure_openai; omitted for Anam's global LLMs.

metadata
object

Free-form provider-specific metadata.

displayTags
string[]

Tags used to categorise the LLM in the Lab UI.

isDefault
boolean

Whether this LLM is a built-in default available to every organization.

isGlobal
boolean

Whether this LLM is visible to every organization.

isZdr
boolean

Whether this LLM meets the Zero Data Retention requirements.

isDeprecated
boolean
read-only

Whether this stock LLM is deprecated. Deprecated LLMs remain available to ephemeral sessions but cannot be newly assigned to personas.

reasoningEffort
string | null

Reasoning effort hint for models that accept it. Forwarded verbatim to the provider/engine; supported values depend on the model. Null means the model default is used.

reasoningFormat
enum<string> | null

Reasoning format hint for models that accept it. Null means the model default is used.

Available options:
parsed,
hidden,
null
createdByOrganizationId
string | null

ID of the organization that created the LLM, or null for global defaults. IDs may be either UUIDs or nanoid-style strings depending on when the organization was created.

createdAt
string<date-time>

Timestamp when the LLM was created.

updatedAt
string<date-time> | null

Timestamp when the LLM was last updated.