Templates and models API

List extraction models

GET/v1/models/extraction

Models an agent may use for post-call analysis, with an estimated cost.

Returns

200 with the fields below.

defaultstringrequired

The model used when an agent does not choose one.

modelsarray<object>required

Models you can use for post-call analysis.

4 properties
idstringrequired

The model id. Put it in an agent's `post_call_analysis_model`.

providerstringrequired

Who runs the model, such as `anthropic` or `openai`.

labelstringrequired

Display name.

est_cost_per_sessionnumberrequired

Estimated cost in US dollars of one typical post-call analysis. A guide for comparing models, not a charge.

curl "https://api.dialgem.com/v1/models/extraction" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
{
  "default": "string",
  "models": [
    {
      "id": "string",
      "provider": "string",
      "label": "string",
      "est_cost_per_session": 0
    }
  ]
}

List flow templates

GET/v1/flow-templates

Every built-in template, as summaries.

Query parameters

categorystring

Returns

200.

curl "https://api.dialgem.com/v1/flow-templates" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
[
  {
    "id": "string",
    "name": "Example",
    "description": "string",
    "setup_note": "string",
    "category": "string",
    "tags": [
      "string"
    ],
    "use_case": "string",
    "icon": "string",
    "source": "string",
    "node_count": 0,
    "node_types": [
      "string"
    ],
    "unsupported_node_types": [
      "string"
    ]
  }
]

Get flow template

GET/v1/flow-templates/{template_id}

One template, with its wire blob.

Path parameters

template_idstringrequired

Returns

200 with the fields below.

idstringrequired

The template's id. Pass it to the detail endpoint to get the full flow.

namestringrequired

Display name.

descriptionstringrequired

What the template does.

setup_notestringrequired

What you need to fill in or change before the template works for your business.

categorystringrequired

Group the template belongs to, for filtering.

tagsarray<string>required

Short labels describing the template.

use_casestringrequired

The kind of call the template is built for.

iconstringrequired

Name of the icon to show next to the template.

sourcestringrequired

Where the template comes from.

node_countintegerrequired

How many nodes the flow has.

Show 7 more parameters
node_typesarray<string>required

The node types the flow uses, in the order they appear.

unsupported_node_typesarray<string>required

Node types in the flow that are not executed yet on this platform. They are skipped during a call.

path_countsobjectrequired

How many nodes are on each kind of path, keyed by path name.

runnablebooleanrequired

True if an agent built from this template can take or place calls.

unsupported_nodesarray<object>required

The individual nodes in the flow that are not executed yet.

4 properties
typestringrequired

The node's type.

supportstringrequired

How far this node type is supported, such as `deferred`.

node_idstring

Id of the node in the flow.

namestring

The node's name, if it has one.

not_runnable_reasonsarray<object>required

Why an agent built from this template cannot take calls. Empty when `runnable` is true.

3 properties
reasonstringrequired

Machine-readable reason the flow cannot run on a call.

node_idsarray<string>required

Ids of the nodes that cause it.

messagestringrequired

Plain-language explanation.

flow_configobjectrequired

The flow itself. Pass it as `flow_config` when you create an agent to start from this template.

curl "https://api.dialgem.com/v1/flow-templates/TEMPLATE_ID" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
{
  "id": "string",
  "name": "Example",
  "description": "string",
  "setup_note": "string",
  "category": "string",
  "tags": [
    "string"
  ],
  "use_case": "string",
  "icon": "string",
  "source": "string",
  "node_count": 0,
  "node_types": [
    "string"
  ],
  "unsupported_node_types": [
    "string"
  ]
}

List prompt templates

GET/v1/prompt-templates

Every built-in prompt template, as summaries.

Query parameters

categorystring

Returns

200.

curl "https://api.dialgem.com/v1/prompt-templates" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
[
  {
    "id": "string",
    "name": "Example",
    "description": "string",
    "setup_note": "string",
    "category": "string",
    "tags": [
      "string"
    ],
    "use_case": "string",
    "icon": "string",
    "source": "string",
    "agent_type": "llm",
    "variable_names": [
      "string"
    ],
    "base": "string"
  }
]

Get prompt template

GET/v1/prompt-templates/{template_id}

One template, with the prompt and first message to create an agent from.

Path parameters

template_idstringrequired

Returns

200 with the fields below.

idstringrequired

The template's id. Pass it to the detail endpoint to get the full prompt.

namestringrequired

Display name.

descriptionstringrequired

What the template does.

setup_notestringrequired

What you need to fill in or change before the template works for your business.

categorystringrequired

Group the template belongs to, for filtering.

tagsarray<string>required

Short labels describing the template.

use_casestringrequired

The kind of call the template is built for.

iconstringrequired

Name of the icon to show next to the template.

sourcestringrequired

Where the template comes from.

variable_namesarray<string>required

Names of the variables you fill in to make the template yours.

Show 6 more parameters
system_prompt_charsintegerrequired

Length of the system prompt in characters, so you can tell a full prompt from a stub without fetching it.

system_promptstringrequired

The agent's system prompt. Pass it as `system_prompt` when you create an agent.

first_messagestringrequired

What the agent says first. Pass it as `first_message` when you create an agent.

agent_typestring

The kind of agent the template creates. Always `llm` for prompt templates.

Default "llm"

basestring

The template this one inherits its prompt from. Null if it stands alone.

default_dynamic_variablesobject

Default values for the template's variables.

curl "https://api.dialgem.com/v1/prompt-templates/TEMPLATE_ID" \
  -H "X-API-Key: $DIALGEM_API_KEY"
Response 200
{
  "id": "string",
  "name": "Example",
  "description": "string",
  "setup_note": "string",
  "category": "string",
  "tags": [
    "string"
  ],
  "use_case": "string",
  "icon": "string",
  "source": "string",
  "agent_type": "llm",
  "variable_names": [
    "string"
  ],
  "base": "string"
}