update llm

Update an LLM configuration

PUT /v1/llms/{id}

update llm

cURL

curl --request PUT \
  --url https://api.anam.ai/v1/llms/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "temperature": 0.5
}
'

import requests

url = "https://api.anam.ai/v1/llms/{id}"

payload = { "temperature": 0.5 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({temperature: 0.5})
};

fetch('https://api.anam.ai/v1/llms/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anam.ai/v1/llms/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'temperature' => 0.5
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anam.ai/v1/llms/{id}"

	payload := strings.NewReader("{\n  \"temperature\": 0.5\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.anam.ai/v1/llms/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"temperature\": 0.5\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anam.ai/v1/llms/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"temperature\": 0.5\n}"

response = http.request(request)
puts response.read_body

200

{
  "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 · string | null

Reasoning effort for models that accept it. The value is forwarded verbatim to the provider/engine (e.g. default, none, minimal, low, medium, high, xhigh — supported values depend on the model). Set null to clear 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

200

application/json

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.

Show child attributes

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