v3

latestOpenAPI 3.1.02026-08-0150254154.0 KB

voiceAgent > variables

Create an Agent Variable

Creates a new template variable. Variables follow the DG_<VARIABLE_NAME> naming format and can substitute any JSON value in an agent configuration.

post/v1/projects/{project_id}/agent-variables

Path parameters

project_idstring required

The unique identifier of the project

Headers

Authorizationstring required

Use Authorization: Token <API_KEY> Example: Authorization: Token 12345abcdef

Request body

keystring required

The variable name, following the DG_<VARIABLE_NAME> format

{"stackTrail":"components:schemas:CreateAgentVariableV1Request:properties:value","oasType":"schema","type":"unknown","description":"The value to substitute. Can be any valid JSON type (string, number, boolean, object, or array)"}

api_versioninteger

API version. Defaults to 1

Response

Agent variable created successfully

variable_idstring required

The unique identifier of the variable

keystring required

The variable name, following the DG_<VARIABLE_NAME> format

{"stackTrail":"components:schemas:AgentVariableV1:properties:value","oasType":"schema","type":"unknown","description":"The value to substitute. Can be any valid JSON type"}

created_atstring date-time

Timestamp when the variable was created

updated_atstring date-time

Timestamp when the variable was last updated