Skip to main content
POST
/
v1
/
llms
create llm
curl --request POST \
  --url https://api.anam.ai/v1/llms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "My GPT-4o",
  "urls": [
    {
      "url": "https://api.openai.com/v1/chat/completions"
    }
  ],
  "llmFormat": "openai",
  "modelName": "gpt-4o",
  "secret": "sk-…",
  "temperature": 0.7
}
'
{
  "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.

Body

application/json

Endpoint URLs, model name, and credentials for the LLM. secret is encrypted at rest and is never returned in subsequent responses. Set llmFormat to match the upstream API's wire protocol.

​
displayName
string
required
​
urls
object[]
required
​
llmFormat
enum<string>
required
Available options:
openai,
azure_openai,
groq_openai,
gemini,
advanced_voice,
none
​
modelName
string
required
​
secret
string
required
​
description
string
​
metadata
object
​
reasoningEffort
enum<string>
Available options:
default,
low,
medium,
high
​
reasoningFormat
enum<string>
Available options:
parsed,
raw,
hidden

Response

Successfully created 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