LLMs API

List LLMs

GET/v1/llms

Newest first.

Query parameters

limitinteger

Default 50

pagination_keystring

Returns

200 with the fields below.

llmsarray<object>required

Saved LLMs, newest first.

14 properties
idstringrequired

The saved LLM's id.

llm_idstringrequired

The saved LLM's id. Same value as `id`.

namestringrequired

Display name.

created_timestampinteger

Creation time in milliseconds since the Unix epoch.

last_modification_timestampinteger

Time of the last change in milliseconds since the Unix epoch.

system_promptstring

The instructions the model follows on every call.

first_messagestring

What the agent says when the call connects. Null means it waits for the caller.

llm_providerstring

Which model provider answers: `anthropic` or `openai`.

llm_modelstring

The model that answers the caller.

temperaturenumber

How varied the model's replies are.

Show 4 more parameters
max_tokensinteger

The longest reply the model may produce, in tokens.

fallback_llm_providerstring

Provider of the backup model used if the main one fails.

fallback_llm_modelstring

The backup model used if the main one fails.

default_dynamic_variablesobject

Values filled into `{{variables}}` in the prompt when a call does not supply its own.

has_morebooleanrequired

True if more remain.

pagination_keystring

Pass as `pagination_key` to get the next page. Null on the last page.

curl "https://api.dialgem.com/v1/llms" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
{
  "llms": [
    {
      "id": "string",
      "llm_id": "llm_123",
      "name": "Example",
      "created_timestamp": 0,
      "last_modification_timestamp": 0,
      "system_prompt": "string",
      "first_message": "string",
      "llm_provider": "string",
      "llm_model": "string",
      "temperature": 0,
      "max_tokens": 0,
      "fallback_llm_provider": "string"
    }
  ],
  "has_more": false,
  "pagination_key": "string"
}

Create LLM

POST/v1/llms

Save LLM settings. Anything left out takes the same default a new agent gets.

Request body application/json

namestringrequired
system_promptstring
first_messagestring
llm_providerstring

One of anthropic, openai

llm_modelstring
temperaturenumber
max_tokensinteger
fallback_llm_providerstring

One of anthropic, openai

fallback_llm_modelstring
default_dynamic_variablesobject

Returns

201 with the fields below.

idstringrequired

The saved LLM's id.

llm_idstringrequired

The saved LLM's id. Same value as `id`.

namestringrequired

Display name.

created_timestampinteger

Creation time in milliseconds since the Unix epoch.

last_modification_timestampinteger

Time of the last change in milliseconds since the Unix epoch.

system_promptstring

The instructions the model follows on every call.

first_messagestring

What the agent says when the call connects. Null means it waits for the caller.

llm_providerstring

Which model provider answers: `anthropic` or `openai`.

llm_modelstring

The model that answers the caller.

temperaturenumber

How varied the model's replies are.

Show 4 more parameters
max_tokensinteger

The longest reply the model may produce, in tokens.

fallback_llm_providerstring

Provider of the backup model used if the main one fails.

fallback_llm_modelstring

The backup model used if the main one fails.

default_dynamic_variablesobject

Values filled into `{{variables}}` in the prompt when a call does not supply its own.

curl -X POST "https://api.dialgem.com/v1/llms" \
  -H "X-API-Key: $DIALGEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Example"
  }'
Response 201
{
  "id": "string",
  "llm_id": "llm_123",
  "name": "Example",
  "created_timestamp": 0,
  "last_modification_timestamp": 0,
  "system_prompt": "string",
  "first_message": "string",
  "llm_provider": "string",
  "llm_model": "string",
  "temperature": 0,
  "max_tokens": 0,
  "fallback_llm_provider": "string"
}

Get LLM

GET/v1/llms/{llm_id}

Path parameters

llm_idstringrequired

Returns

200 with the fields below.

idstringrequired

The saved LLM's id.

llm_idstringrequired

The saved LLM's id. Same value as `id`.

namestringrequired

Display name.

created_timestampinteger

Creation time in milliseconds since the Unix epoch.

last_modification_timestampinteger

Time of the last change in milliseconds since the Unix epoch.

system_promptstring

The instructions the model follows on every call.

first_messagestring

What the agent says when the call connects. Null means it waits for the caller.

llm_providerstring

Which model provider answers: `anthropic` or `openai`.

llm_modelstring

The model that answers the caller.

temperaturenumber

How varied the model's replies are.

Show 4 more parameters
max_tokensinteger

The longest reply the model may produce, in tokens.

fallback_llm_providerstring

Provider of the backup model used if the main one fails.

fallback_llm_modelstring

The backup model used if the main one fails.

default_dynamic_variablesobject

Values filled into `{{variables}}` in the prompt when a call does not supply its own.

curl "https://api.dialgem.com/v1/llms/LLM_ID" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
{
  "id": "string",
  "llm_id": "llm_123",
  "name": "Example",
  "created_timestamp": 0,
  "last_modification_timestamp": 0,
  "system_prompt": "string",
  "first_message": "string",
  "llm_provider": "string",
  "llm_model": "string",
  "temperature": 0,
  "max_tokens": 0,
  "fallback_llm_provider": "string"
}

Update LLM

PATCH/v1/llms/{llm_id}

Change the fields you send. Agents it was attached to are not touched: they hold their own copy.

Path parameters

llm_idstringrequired

Request body application/json

system_promptstring
first_messagestring
llm_providerstring

One of anthropic, openai

llm_modelstring
temperaturenumber
max_tokensinteger
fallback_llm_providerstring

One of anthropic, openai

fallback_llm_modelstring
default_dynamic_variablesobject
namestring

Returns

200 with the fields below.

idstringrequired

The saved LLM's id.

llm_idstringrequired

The saved LLM's id. Same value as `id`.

namestringrequired

Display name.

created_timestampinteger

Creation time in milliseconds since the Unix epoch.

last_modification_timestampinteger

Time of the last change in milliseconds since the Unix epoch.

system_promptstring

The instructions the model follows on every call.

first_messagestring

What the agent says when the call connects. Null means it waits for the caller.

llm_providerstring

Which model provider answers: `anthropic` or `openai`.

llm_modelstring

The model that answers the caller.

temperaturenumber

How varied the model's replies are.

Show 4 more parameters
max_tokensinteger

The longest reply the model may produce, in tokens.

fallback_llm_providerstring

Provider of the backup model used if the main one fails.

fallback_llm_modelstring

The backup model used if the main one fails.

default_dynamic_variablesobject

Values filled into `{{variables}}` in the prompt when a call does not supply its own.

curl -X PATCH "https://api.dialgem.com/v1/llms/LLM_ID" \
  -H "X-API-Key: $DIALGEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "system_prompt": "string"
  }'
Response 200
{
  "id": "string",
  "llm_id": "llm_123",
  "name": "Example",
  "created_timestamp": 0,
  "last_modification_timestamp": 0,
  "system_prompt": "string",
  "first_message": "string",
  "llm_provider": "string",
  "llm_model": "string",
  "temperature": 0,
  "max_tokens": 0,
  "fallback_llm_provider": "string"
}

Delete LLM

DELETE/v1/llms/{llm_id}

Delete saved LLM settings. Agents they were attached to keep their copy.

Path parameters

llm_idstringrequired

Returns

200 with the fields below.

deletedbooleanrequired

Always true on success.

idstringrequired

The id that was deleted.

curl -X DELETE "https://api.dialgem.com/v1/llms/LLM_ID" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
{
  "deleted": false,
  "id": "string"
}