Skip to main content
PUT
/
v1
/
llms
/
{id}
update llm
curl --request PUT \
  --url https://api.anam.ai/v1/llms/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "temperature": 0.5
}
'
{
  "id": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
  "displayName": "GPT-4o",
  "description": "OpenAI GPT-4o default configuration.",
  "llmFormat": "openai",
  "urls": [
    {
      "url": "https://api.openai.com/v1/chat/completions"
    }
  ],
  "modelName": "gpt-4o",
  "temperature": 0.7,
  "maxTokens": 1024,
  "deploymentName": null,
  "apiVersion": null,
  "metadata": {},
  "displayTags": [
    "openai"
  ],
  "isDefault": true,
  "isGlobal": true,
  "isZdr": false,
  "createdByOrganizationId": null,
  "createdAt": "2026-04-20T10:00:00.000Z",
  "updatedAt": null
}

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 update of the LLM configuration. Only the fields you include are changed. Default LLMs (not owned by your organization) cannot be modified. Rotating secret replaces the stored credential.

​
displayName
string
​
description
string
​
url
string
​
llmFormat
enum<string>
Available options:
openai,
azure_openai,
groq_openai,
anthropic,
custom
​
modelName
string
​
secret
string
​
metadata
object
​
reasoningEffort
enum<string>
Available options:
default,
low,
medium,
high
​
reasoningFormat
enum<string>
Available options:
parsed,
raw,
hidden

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,
advanced_voice,
none
​
urls
object[]

Endpoints configured for this LLM.

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

​
apiVersion
string | null

Azure OpenAI API version. Only used when llmFormat is azure_openai.

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

​
reasoningEffort
enum<string>

Reasoning effort hint for models that accept it.

Available options:
default,
low,
medium,
high
​
reasoningFormat
enum<string>

Reasoning format hint for models that accept it.

Available options:
parsed,
raw,
hidden
​
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.

Last modified on April 22, 2026