LLMs API
List LLMs
Newest first.
Query parameters
Default 50
Returns
200 with the fields below.
Saved LLMs, newest first.
14 properties
The saved LLM's id.
The saved LLM's id. Same value as `id`.
Display name.
Creation time in milliseconds since the Unix epoch.
Time of the last change in milliseconds since the Unix epoch.
The instructions the model follows on every call.
What the agent says when the call connects. Null means it waits for the caller.
Which model provider answers: `anthropic` or `openai`.
The model that answers the caller.
How varied the model's replies are.
Show 4 more parameters
The longest reply the model may produce, in tokens.
Provider of the backup model used if the main one fails.
The backup model used if the main one fails.
Values filled into `{{variables}}` in the prompt when a call does not supply its own.
True if more remain.
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"{
"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
Save LLM settings. Anything left out takes the same default a new agent gets.
Request body application/json
One of anthropic, openai
One of anthropic, openai
Returns
201 with the fields below.
The saved LLM's id.
The saved LLM's id. Same value as `id`.
Display name.
Creation time in milliseconds since the Unix epoch.
Time of the last change in milliseconds since the Unix epoch.
The instructions the model follows on every call.
What the agent says when the call connects. Null means it waits for the caller.
Which model provider answers: `anthropic` or `openai`.
The model that answers the caller.
How varied the model's replies are.
Show 4 more parameters
The longest reply the model may produce, in tokens.
Provider of the backup model used if the main one fails.
The backup model used if the main one fails.
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"
}'{
"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
Path parameters
Returns
200 with the fields below.
The saved LLM's id.
The saved LLM's id. Same value as `id`.
Display name.
Creation time in milliseconds since the Unix epoch.
Time of the last change in milliseconds since the Unix epoch.
The instructions the model follows on every call.
What the agent says when the call connects. Null means it waits for the caller.
Which model provider answers: `anthropic` or `openai`.
The model that answers the caller.
How varied the model's replies are.
Show 4 more parameters
The longest reply the model may produce, in tokens.
Provider of the backup model used if the main one fails.
The backup model used if the main one fails.
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"{
"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
Change the fields you send. Agents it was attached to are not touched: they hold their own copy.
Path parameters
Request body application/json
One of anthropic, openai
One of anthropic, openai
Returns
200 with the fields below.
The saved LLM's id.
The saved LLM's id. Same value as `id`.
Display name.
Creation time in milliseconds since the Unix epoch.
Time of the last change in milliseconds since the Unix epoch.
The instructions the model follows on every call.
What the agent says when the call connects. Null means it waits for the caller.
Which model provider answers: `anthropic` or `openai`.
The model that answers the caller.
How varied the model's replies are.
Show 4 more parameters
The longest reply the model may produce, in tokens.
Provider of the backup model used if the main one fails.
The backup model used if the main one fails.
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"
}'{
"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 saved LLM settings. Agents they were attached to keep their copy.
Path parameters
Returns
200 with the fields below.
Always true on success.
The id that was deleted.
curl -X DELETE "https://api.dialgem.com/v1/llms/LLM_ID" \
-H "X-API-Key: $DIALGEM_API_KEY"{
"deleted": false,
"id": "string"
}