Agents API
List agents
Returns
200.
curl "https://api.dialgem.com/v1/agents" \
-H "X-API-Key: $DIALGEM_API_KEY"[
{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"agent_type": "string",
"system_prompt": "string",
"llm_provider": "string",
"llm_model": "string",
"tts_engine": "string",
"voice_id": "voice_123",
"first_message": "string",
"temperature": 0,
"max_tokens": 0
}
]Create agent
Request body application/json
One of llm, multi_prompt, flow
Default "llm"
4 properties
3 properties
14 properties
Default "POST"
Default 10000
Show 4 more parameters
Default true
Default false
One of custom, check_availability_cal, book_appointment_cal, cancel_appointment_cal, reschedule_appointment_cal, check_availability_gcal, book_appointment_gcal, end_call, transfer_call, press_digit, agent_swap
Default "custom"
One of anthropic, openai
Default "cartesia"
Show 58 more parameters
Default 0.7
Default 150
23 properties
21 properties
Show 11 more parameters
One of user, agent
3 properties
2 properties
Show 13 more parameters
11 properties
2 properties
5 properties
Default 1
Default 1
Default false
Default 0.8
Default 10000
5 properties
One of ipa, cmu
Default false
Default false
One of none, coffee-shop, call-center, convention-hall, summer-outdoor, mountain-outdoor, static-noise
Default "none"
Default 1
Default 1
Default 0.5
One of whisper, conformer, deepgram
Default "en"
Default false
One of off, noise-cancellation, noise-and-background-speech-cancellation
Default "off"
Default false
Default 0.5
One of fast, accurate
Default "fast"
One of general, medical
Default "general"
Default 0
Default 600000
Default 3600000
Default 30000
Default false
One of hangup, leave_message
Default "hangup"
Default false
Default false
Default false
6 properties
One of string, number, boolean, enum
Default false
Default "claude-sonnet-4-6"
One of anthropic, openai
Default false
Default false
Default false
One of everything, everything_except_pii, basic_attributes_only
Default "everything"
Default 10000
Returns
201 with the fields below.
The agent's id.
The agent's id. Same value as `id`.
Display name.
How the agent is driven: `llm`, `multi_prompt` or `flow`.
The instructions the model follows on every call.
Which model provider answers: `anthropic` or `openai`.
The model that answers the caller.
The speech engine that voices the agent.
The voice the agent speaks with.
How varied the model's replies are.
Show 65 more parameters
The longest reply the model may produce, in tokens.
The prompt states of a `multi_prompt` agent. Empty for other agent types.
Values filled into `{{variables}}` in the prompt when a call does not supply its own.
How quickly the agent replies once the caller stops talking, from 0 to 1.
How easily the caller can interrupt the agent, from 0 to 1.
Whether the agent says short acknowledgements such as "uh-huh" while the caller talks.
How often the agent backchannels, from 0 to 1.
How long the caller can stay silent, in milliseconds, before the agent sends a reminder.
What the agent says as a reminder. Empty means the model decides.
Words with a spoken form to use instead of the default.
Whether keypad presses from the caller are passed to the agent.
How keypad input is collected: digit limit, end key and timeout.
Background sound mixed into the call, or `none`.
Volume of the background sound.
Speaking speed. 1.0 is normal.
How expressive the voice is, from 0 to 1.
The speech recognition model that transcribes the caller.
The language the agent listens for.
Whether transcripts get punctuation and number formatting.
Words the speech recognizer should favor.
How background noise is removed from the caller's audio.
Whether the agent waits longer when the caller sounds unfinished.
How aggressively noise is removed, from 0 to 1.
Whether transcription favors speed (`fast`) or accuracy.
The vocabulary the recognizer is tuned for, such as `general` or `medical`.
How long the agent waits before its first message, in milliseconds.
The call ends after this much silence, in milliseconds.
The longest a call may run, in milliseconds.
How long an outbound call rings before giving up, in milliseconds.
Whether the agent detects when a voicemail box answers.
What to do on voicemail: `hangup` or `leave_message`.
The message left on voicemail when `voicemail_action` is `leave_message`.
Extra instructions that help the agent recognize a voicemail greeting.
Whether the agent hangs up when it reaches an automated phone menu.
Extra instructions that help the agent recognize an automated phone menu.
Whether the agent handles call-screening prompts.
What the agent says to a call-screening prompt.
Whether the agent ends the call when the caller asks not to be contacted again.
Custom fields extracted from every call after it ends.
The model that analyzes calls after they end.
Settings for the built-in analysis fields: `call_summary`, `call_successful` and `user_sentiment`. A field you have not customized is absent.
Whether personal information is removed from stored transcripts.
True if calls are not recorded.
True if transcripts are not stored.
What call data is stored, such as `everything`.
The kinds of personal information that are redacted.
The call events sent to the webhook.
Whether a signing secret is set.
How long to wait for the webhook to answer, in milliseconds.
Numbers that send calls to, or place calls from, this agent. Only filled in the list response.
How many calls the agent has handled. Zero in the create and update responses.
What the agent says when the call connects. Null means it waits for the caller to speak first.
The conversation flow, for `flow` agents. Null for other agent types.
The name of the state a `multi_prompt` agent starts in.
The most reminders sent in a row. Null means no limit.
Provider of the backup model used if the main one fails.
The backup model used if the main one fails.
The backup voice used if the main one fails.
Days call data is kept before deletion. Null keeps it until you delete it.
Where call events are sent for this agent.
The secret used to sign webhook deliveries. Returned when you create, fetch or update one agent, and null in the list.
ISO 8601 creation time.
ISO 8601 time of the last change.
The folder the agent is in. Null means it is under All agents.
Present only when a flow was saved with warnings.
1 properties
Warnings found in the flow. The flow was still saved. Each issue says where the problem is and what it is.
curl -X POST "https://api.dialgem.com/v1/agents" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Example"
}'{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"agent_type": "string",
"system_prompt": "string",
"llm_provider": "string",
"llm_model": "string",
"tts_engine": "string",
"voice_id": "voice_123",
"first_message": "string",
"temperature": 0,
"max_tokens": 0
}Get agent
Path parameters
Returns
200 with the fields below.
The agent's id.
The agent's id. Same value as `id`.
Display name.
How the agent is driven: `llm`, `multi_prompt` or `flow`.
The instructions the model follows on every call.
Which model provider answers: `anthropic` or `openai`.
The model that answers the caller.
The speech engine that voices the agent.
The voice the agent speaks with.
How varied the model's replies are.
Show 65 more parameters
The longest reply the model may produce, in tokens.
The prompt states of a `multi_prompt` agent. Empty for other agent types.
Values filled into `{{variables}}` in the prompt when a call does not supply its own.
How quickly the agent replies once the caller stops talking, from 0 to 1.
How easily the caller can interrupt the agent, from 0 to 1.
Whether the agent says short acknowledgements such as "uh-huh" while the caller talks.
How often the agent backchannels, from 0 to 1.
How long the caller can stay silent, in milliseconds, before the agent sends a reminder.
What the agent says as a reminder. Empty means the model decides.
Words with a spoken form to use instead of the default.
Whether keypad presses from the caller are passed to the agent.
How keypad input is collected: digit limit, end key and timeout.
Background sound mixed into the call, or `none`.
Volume of the background sound.
Speaking speed. 1.0 is normal.
How expressive the voice is, from 0 to 1.
The speech recognition model that transcribes the caller.
The language the agent listens for.
Whether transcripts get punctuation and number formatting.
Words the speech recognizer should favor.
How background noise is removed from the caller's audio.
Whether the agent waits longer when the caller sounds unfinished.
How aggressively noise is removed, from 0 to 1.
Whether transcription favors speed (`fast`) or accuracy.
The vocabulary the recognizer is tuned for, such as `general` or `medical`.
How long the agent waits before its first message, in milliseconds.
The call ends after this much silence, in milliseconds.
The longest a call may run, in milliseconds.
How long an outbound call rings before giving up, in milliseconds.
Whether the agent detects when a voicemail box answers.
What to do on voicemail: `hangup` or `leave_message`.
The message left on voicemail when `voicemail_action` is `leave_message`.
Extra instructions that help the agent recognize a voicemail greeting.
Whether the agent hangs up when it reaches an automated phone menu.
Extra instructions that help the agent recognize an automated phone menu.
Whether the agent handles call-screening prompts.
What the agent says to a call-screening prompt.
Whether the agent ends the call when the caller asks not to be contacted again.
Custom fields extracted from every call after it ends.
The model that analyzes calls after they end.
Settings for the built-in analysis fields: `call_summary`, `call_successful` and `user_sentiment`. A field you have not customized is absent.
Whether personal information is removed from stored transcripts.
True if calls are not recorded.
True if transcripts are not stored.
What call data is stored, such as `everything`.
The kinds of personal information that are redacted.
The call events sent to the webhook.
Whether a signing secret is set.
How long to wait for the webhook to answer, in milliseconds.
Numbers that send calls to, or place calls from, this agent. Only filled in the list response.
How many calls the agent has handled. Zero in the create and update responses.
What the agent says when the call connects. Null means it waits for the caller to speak first.
The conversation flow, for `flow` agents. Null for other agent types.
The name of the state a `multi_prompt` agent starts in.
The most reminders sent in a row. Null means no limit.
Provider of the backup model used if the main one fails.
The backup model used if the main one fails.
The backup voice used if the main one fails.
Days call data is kept before deletion. Null keeps it until you delete it.
Where call events are sent for this agent.
The secret used to sign webhook deliveries. Returned when you create, fetch or update one agent, and null in the list.
ISO 8601 creation time.
ISO 8601 time of the last change.
The folder the agent is in. Null means it is under All agents.
Present only when a flow was saved with warnings.
1 properties
Warnings found in the flow. The flow was still saved. Each issue says where the problem is and what it is.
curl "https://api.dialgem.com/v1/agents/AGENT_ID" \
-H "X-API-Key: $DIALGEM_API_KEY"{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"agent_type": "string",
"system_prompt": "string",
"llm_provider": "string",
"llm_model": "string",
"tts_engine": "string",
"voice_id": "voice_123",
"first_message": "string",
"temperature": 0,
"max_tokens": 0
}Update agent
Path parameters
Request body application/json
One of llm, multi_prompt, flow
4 properties
3 properties
14 properties
Default "POST"
Default 10000
Show 4 more parameters
Default true
Default false
One of custom, check_availability_cal, book_appointment_cal, cancel_appointment_cal, reschedule_appointment_cal, check_availability_gcal, book_appointment_gcal, end_call, transfer_call, press_digit, agent_swap
Default "custom"
One of anthropic, openai
Show 59 more parameters
23 properties
21 properties
Show 11 more parameters
One of user, agent
3 properties
2 properties
Show 13 more parameters
11 properties
2 properties
5 properties
5 properties
One of ipa, cmu
Default false
3 properties
One of 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, #, *
Default 2500
One of none, coffee-shop, call-center, convention-hall, summer-outdoor, mountain-outdoor, static-noise
One of whisper, conformer, deepgram
One of off, noise-cancellation, noise-and-background-speech-cancellation
One of fast, accurate
One of general, medical
One of hangup, leave_message
6 properties
One of string, number, boolean, enum
Default false
3 properties
3 properties
Default true
3 properties
Default true
3 properties
Default true
One of anthropic, openai
One of everything, everything_except_pii, basic_attributes_only
Returns
200 with the fields below.
The agent's id.
The agent's id. Same value as `id`.
Display name.
How the agent is driven: `llm`, `multi_prompt` or `flow`.
The instructions the model follows on every call.
Which model provider answers: `anthropic` or `openai`.
The model that answers the caller.
The speech engine that voices the agent.
The voice the agent speaks with.
How varied the model's replies are.
Show 65 more parameters
The longest reply the model may produce, in tokens.
The prompt states of a `multi_prompt` agent. Empty for other agent types.
Values filled into `{{variables}}` in the prompt when a call does not supply its own.
How quickly the agent replies once the caller stops talking, from 0 to 1.
How easily the caller can interrupt the agent, from 0 to 1.
Whether the agent says short acknowledgements such as "uh-huh" while the caller talks.
How often the agent backchannels, from 0 to 1.
How long the caller can stay silent, in milliseconds, before the agent sends a reminder.
What the agent says as a reminder. Empty means the model decides.
Words with a spoken form to use instead of the default.
Whether keypad presses from the caller are passed to the agent.
How keypad input is collected: digit limit, end key and timeout.
Background sound mixed into the call, or `none`.
Volume of the background sound.
Speaking speed. 1.0 is normal.
How expressive the voice is, from 0 to 1.
The speech recognition model that transcribes the caller.
The language the agent listens for.
Whether transcripts get punctuation and number formatting.
Words the speech recognizer should favor.
How background noise is removed from the caller's audio.
Whether the agent waits longer when the caller sounds unfinished.
How aggressively noise is removed, from 0 to 1.
Whether transcription favors speed (`fast`) or accuracy.
The vocabulary the recognizer is tuned for, such as `general` or `medical`.
How long the agent waits before its first message, in milliseconds.
The call ends after this much silence, in milliseconds.
The longest a call may run, in milliseconds.
How long an outbound call rings before giving up, in milliseconds.
Whether the agent detects when a voicemail box answers.
What to do on voicemail: `hangup` or `leave_message`.
The message left on voicemail when `voicemail_action` is `leave_message`.
Extra instructions that help the agent recognize a voicemail greeting.
Whether the agent hangs up when it reaches an automated phone menu.
Extra instructions that help the agent recognize an automated phone menu.
Whether the agent handles call-screening prompts.
What the agent says to a call-screening prompt.
Whether the agent ends the call when the caller asks not to be contacted again.
Custom fields extracted from every call after it ends.
The model that analyzes calls after they end.
Settings for the built-in analysis fields: `call_summary`, `call_successful` and `user_sentiment`. A field you have not customized is absent.
Whether personal information is removed from stored transcripts.
True if calls are not recorded.
True if transcripts are not stored.
What call data is stored, such as `everything`.
The kinds of personal information that are redacted.
The call events sent to the webhook.
Whether a signing secret is set.
How long to wait for the webhook to answer, in milliseconds.
Numbers that send calls to, or place calls from, this agent. Only filled in the list response.
How many calls the agent has handled. Zero in the create and update responses.
What the agent says when the call connects. Null means it waits for the caller to speak first.
The conversation flow, for `flow` agents. Null for other agent types.
The name of the state a `multi_prompt` agent starts in.
The most reminders sent in a row. Null means no limit.
Provider of the backup model used if the main one fails.
The backup model used if the main one fails.
The backup voice used if the main one fails.
Days call data is kept before deletion. Null keeps it until you delete it.
Where call events are sent for this agent.
The secret used to sign webhook deliveries. Returned when you create, fetch or update one agent, and null in the list.
ISO 8601 creation time.
ISO 8601 time of the last change.
The folder the agent is in. Null means it is under All agents.
Present only when a flow was saved with warnings.
1 properties
Warnings found in the flow. The flow was still saved. Each issue says where the problem is and what it is.
curl -X PATCH "https://api.dialgem.com/v1/agents/AGENT_ID" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Example"
}'{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"agent_type": "string",
"system_prompt": "string",
"llm_provider": "string",
"llm_model": "string",
"tts_engine": "string",
"voice_id": "voice_123",
"first_message": "string",
"temperature": 0,
"max_tokens": 0
}Delete agent
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/agents/AGENT_ID" \
-H "X-API-Key: $DIALGEM_API_KEY"{
"deleted": false,
"id": "string"
}List functions
Path parameters
Returns
200.
curl "https://api.dialgem.com/v1/agents/AGENT_ID/functions" \
-H "X-API-Key: $DIALGEM_API_KEY"[
{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"description": "string",
"parameters": {},
"url": "https://example.com",
"method": "string",
"timeout_ms": 0,
"headers": [
{}
],
"query_params": [
{}
],
"speak_during_execution": "string",
"speak_after_execution": false
}
]Create function
Path parameters
Request body application/json
Default "POST"
Default 10000
2 properties
2 properties
Default true
Show 4 more parameters
Default false
One of custom, end_call, transfer_call, press_digit, agent_swap, check_availability_cal, book_appointment_cal, cancel_appointment_cal, reschedule_appointment_cal, check_availability_gcal, book_appointment_gcal
Default "custom"
Returns
201 with the fields below.
The function's id.
The agent it belongs to.
The name the model calls the function by.
What the function does, shown to the model so it knows when to call it.
JSON Schema for the arguments the model passes.
The endpoint called for a `custom` function. Empty for built-in kinds.
HTTP method used for a `custom` function.
How long to wait for the endpoint, in milliseconds.
Headers sent with the request, as `{key, value}` pairs.
Query parameters sent with the request, as `{key, value}` pairs.
Show 8 more parameters
Whether the agent speaks again once the function returns.
Whether the arguments are sent as the whole request body.
Position in the agent's function list.
`custom` for your own endpoint, or the built-in action such as `end_call` or `transfer_call`.
Settings for a built-in kind. Empty for `custom`.
Values taken from the response and saved as variables, as variable name to path.
What the agent says while the function runs. Null means it stays quiet.
ISO 8601 creation time.
curl -X POST "https://api.dialgem.com/v1/agents/AGENT_ID/functions" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Example"
}'{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"description": "string",
"parameters": {},
"url": "https://example.com",
"method": "string",
"timeout_ms": 0,
"headers": [
{}
],
"query_params": [
{}
],
"speak_during_execution": "string",
"speak_after_execution": false
}Reorder functions
Path parameters
Request body application/json
Returns
204 with the resulting object.
curl -X POST "https://api.dialgem.com/v1/agents/AGENT_ID/functions/reorder" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"order": [
"string"
]
}'Update function
Path parameters
Request body application/json
2 properties
2 properties
Returns
200 with the fields below.
The function's id.
The agent it belongs to.
The name the model calls the function by.
What the function does, shown to the model so it knows when to call it.
JSON Schema for the arguments the model passes.
The endpoint called for a `custom` function. Empty for built-in kinds.
HTTP method used for a `custom` function.
How long to wait for the endpoint, in milliseconds.
Headers sent with the request, as `{key, value}` pairs.
Query parameters sent with the request, as `{key, value}` pairs.
Show 8 more parameters
Whether the agent speaks again once the function returns.
Whether the arguments are sent as the whole request body.
Position in the agent's function list.
`custom` for your own endpoint, or the built-in action such as `end_call` or `transfer_call`.
Settings for a built-in kind. Empty for `custom`.
Values taken from the response and saved as variables, as variable name to path.
What the agent says while the function runs. Null means it stays quiet.
ISO 8601 creation time.
curl -X PATCH "https://api.dialgem.com/v1/agents/AGENT_ID/functions/FUNCTION_ID" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "string"
}'{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"description": "string",
"parameters": {},
"url": "https://example.com",
"method": "string",
"timeout_ms": 0,
"headers": [
{}
],
"query_params": [
{}
],
"speak_during_execution": "string",
"speak_after_execution": false
}Delete function
Path parameters
Returns
204 with the resulting object.
curl -X DELETE "https://api.dialgem.com/v1/agents/AGENT_ID/functions/FUNCTION_ID" \
-H "X-API-Key: $DIALGEM_API_KEY"List documents
Path parameters
Returns
200.
curl "https://api.dialgem.com/v1/agents/AGENT_ID/knowledge" \
-H "X-API-Key: $DIALGEM_API_KEY"[
{
"source_id": "source_123",
"filename": "string",
"chunk_count": 0,
"embedded": false,
"created_at": "string"
}
]Add a document
Path parameters
Request body application/json
Returns
201 with the fields below.
The id of the document. Use it to delete the document.
How many pieces the document was split into for search.
True once every piece is searchable.
The name the document was added under.
curl -X POST "https://api.dialgem.com/v1/agents/AGENT_ID/knowledge" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filename": "string",
"content": "string"
}'{
"source_id": "source_123",
"filename": "string",
"chunk_count": 0,
"embedded": false
}Delete document
Path parameters
Returns
204 with the resulting object.
curl -X DELETE "https://api.dialgem.com/v1/agents/AGENT_ID/knowledge/SOURCE_ID" \
-H "X-API-Key: $DIALGEM_API_KEY"List MCP servers
Path parameters
Returns
200.
curl "https://api.dialgem.com/v1/agents/AGENT_ID/mcp-servers" \
-H "X-API-Key: $DIALGEM_API_KEY"[
{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"url": "https://example.com",
"has_auth_token": false,
"enabled": false,
"timeout_ms": 0,
"headers": [
{}
],
"query_params": [
{}
],
"last_status": {},
"created_at": "string"
}
]Create MCP server
Path parameters
Request body application/json
Default true
Default 10000
2 properties
2 properties
Returns
201 with the fields below.
The MCP server's id.
The agent it belongs to.
The name the agent's tools from this server are grouped under.
The server's address.
Whether an auth token is stored. The token itself is never returned.
Whether the agent uses this server.
How long to wait for the server, in milliseconds.
Headers sent with each request, as `{key, value}` pairs.
Query parameters sent with each request, as `{key, value}` pairs.
The result of the last connection test: `ok`, `tools`, `error` and `at`. Null if never tested.
ISO 8601 creation time.
curl -X POST "https://api.dialgem.com/v1/agents/AGENT_ID/mcp-servers" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Example",
"url": "https://example.com"
}'{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"url": "https://example.com",
"has_auth_token": false,
"enabled": false,
"timeout_ms": 0,
"headers": [
{}
],
"query_params": [
{}
],
"last_status": {},
"created_at": "string"
}Update MCP server
Path parameters
Request body application/json
2 properties
2 properties
Returns
200 with the fields below.
The MCP server's id.
The agent it belongs to.
The name the agent's tools from this server are grouped under.
The server's address.
Whether an auth token is stored. The token itself is never returned.
Whether the agent uses this server.
How long to wait for the server, in milliseconds.
Headers sent with each request, as `{key, value}` pairs.
Query parameters sent with each request, as `{key, value}` pairs.
The result of the last connection test: `ok`, `tools`, `error` and `at`. Null if never tested.
ISO 8601 creation time.
curl -X PATCH "https://api.dialgem.com/v1/agents/AGENT_ID/mcp-servers/SERVER_ID" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com"
}'{
"id": "string",
"agent_id": "agent_123",
"name": "Example",
"url": "https://example.com",
"has_auth_token": false,
"enabled": false,
"timeout_ms": 0,
"headers": [
{}
],
"query_params": [
{}
],
"last_status": {},
"created_at": "string"
}Delete MCP server
Path parameters
Returns
204 with the resulting object.
curl -X DELETE "https://api.dialgem.com/v1/agents/AGENT_ID/mcp-servers/SERVER_ID" \
-H "X-API-Key: $DIALGEM_API_KEY"Test MCP server
Attempt a live connection, persist the result, and return it.
Path parameters
Returns
200 with the fields below.
True if the server was reached.
Names of the tools the server offers.
ISO 8601 time of the test.
Why the connection failed. Null on success.
curl -X POST "https://api.dialgem.com/v1/agents/AGENT_ID/mcp-servers/SERVER_ID/test" \
-H "X-API-Key: $DIALGEM_API_KEY"{
"ok": false,
"tools": [
"string"
],
"error": "string",
"at": "string"
}List MCP server tools
What the server offers right now: `{tools: [{name, description, input_schema}], error}`.
Path parameters
Returns
200 with the fields below.
The tools the server offers right now. Empty if it could not be reached.
3 properties
The tool's name.
What the tool does.
JSON Schema for the tool's arguments.
Why the server could not be reached. Null on success.
curl "https://api.dialgem.com/v1/agents/AGENT_ID/mcp-servers/SERVER_ID/tools" \
-H "X-API-Key: $DIALGEM_API_KEY"{
"tools": [
{
"name": "Example",
"description": "string",
"input_schema": {}
}
],
"error": "string"
}List agent versions
Published versions, newest first. The draft (0) is not one of them.
Path parameters
Query parameters
Default 50
Return versions below this one. Page by passing the last `version` of the previous page.
Returns
200 with the fields below.
Published versions, newest first.
10 properties
The version record's id.
The agent the version belongs to.
The version number. The first published version is 1.
The agent's name when the version was published.
How many functions the version holds.
How many MCP servers the version holds.
A label you gave the release.
Notes you gave the release.
ISO 8601 time the version was published.
Who published it.
True if older versions remain. Pass the last `version` as `before_version` to get them.
curl "https://api.dialgem.com/v1/agents/AGENT_ID/versions" \
-H "X-API-Key: $DIALGEM_API_KEY"{
"versions": [
{
"id": "string",
"agent_id": "agent_123",
"version": 0,
"name": "Example",
"title": "Example",
"description": "string",
"published_at": "string",
"published_by": "string",
"function_count": 0,
"mcp_server_count": 0
}
],
"has_more": false
}Publish agent version
Freeze the agent's current state as the next version.
Path parameters
Request body application/json
Returns
201 with the fields below.
The version record's id.
The agent the version belongs to.
The version number. The first published version is 1.
The agent's name when the version was published.
How many functions the version holds.
How many MCP servers the version holds.
The agent's configuration as published, without secrets.
The agent's functions as published.
The agent's MCP servers as published, without auth tokens.
A label you gave the release.
Show 4 more parameters
Notes you gave the release.
ISO 8601 time the version was published.
Who published it.
Present when the version was published although a required test suite has not passed.
curl -X POST "https://api.dialgem.com/v1/agents/AGENT_ID/versions" \
-H "X-API-Key: $DIALGEM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Example"
}'{
"id": "string",
"agent_id": "agent_123",
"version": 0,
"name": "Example",
"title": "Example",
"description": "string",
"published_at": "string",
"published_by": "string",
"function_count": 0,
"mcp_server_count": 0,
"config": {},
"functions": [
{}
]
}Get agent version
Path parameters
Returns
200 with the fields below.
The version record's id.
The agent the version belongs to.
The version number. The first published version is 1.
The agent's name when the version was published.
How many functions the version holds.
How many MCP servers the version holds.
The agent's configuration as published, without secrets.
The agent's functions as published.
The agent's MCP servers as published, without auth tokens.
A label you gave the release.
Show 3 more parameters
Notes you gave the release.
ISO 8601 time the version was published.
Who published it.
curl "https://api.dialgem.com/v1/agents/AGENT_ID/versions/VERSION" \
-H "X-API-Key: $DIALGEM_API_KEY"{
"id": "string",
"agent_id": "agent_123",
"version": 0,
"name": "Example",
"title": "Example",
"description": "string",
"published_at": "string",
"published_by": "string",
"function_count": 0,
"mcp_server_count": 0,
"config": {},
"functions": [
{}
]
}