Get Call Flow
Retrieve a specific call flow by its ID.
Headers
x-api-keystringrequiredAPI key used for authenticating requests to the API.
x-workspace-idstringrequiredWorkspace identifier for the API.
Path Parameters
idstringrequiredThe unique ID of the call flow.
Response Fields
_idstringThe unique identifier for the call flow.
workspaceIdstringThe identifier of the workspace where the call flow is configured.
namestringThe name assigned to the call flow.
directionstringIndicates the direction of the call flow, such as "inbound".
descriptionstringA brief description of what the call flow is designed to handle.
agentstringThe ID of the agent associated with this call flow.
promptTypestringThe type of prompt used in the call flow, such as "simple".
flowDataobjectContains the configuration of nodes and edges defining the call routing logic.
nodesarrayAn array detailing each node in the call flow.
edgesarrayAn array detailing the edges connecting the nodes.
promptstringThe initial or system prompt that is presented in the call flow.
isActivebooleanIndicates whether the call flow is currently active.
settingsobjectThe configuration settings for the call flow, including details on knowledge bases, response settings, security measures, and call settings.
knowledgeBasesarrayAn array of references to knowledge bases included in the call flow.
responseSettingsobjectSettings related to response timing within the call flow.
delaynumberThe delay before a response is issued, measured in seconds.
securityobjectSecurity settings relevant to the call flow.
hipaaCompliancebooleanIndicates whether HIPAA compliance is enabled.
callSettingobjectCall-related settings for managing the call duration and handling silence.
maxCallDurationnumberThe maximum duration for the call, measured in seconds.
endCallOnSilencenumberThe duration of silence that triggers the end of the call, measured in seconds.
createdAtstringTimestamp when the call flow was created.
updatedAtstringTimestamp when the call flow was last updated.
{
"_id": "exampleId",
"workspaceId": "workspacePlaceholder",
"name": "Customer Support Flow",
"direction": "inbound",
"description": "Handles inbound support calls",
"agent": "agentPlaceholder",
"promptType": "simple",
"flowData": {
"nodes": [],
"edges": []
},
"prompt": "Keep the conversation short and friendly.",
"isActive": true,
"settings": {
"knowledgeBases": [],
"responseSettings": { "delay": 0 },
"security": { "hipaaCompliance": false },
"callSetting": { "maxCallDuration": 600, "endCallOnSilence": 10 }
},
"createdAt": "2025-01-03T11:00:00Z",
"updatedAt": "2025-01-03T11:10:00Z"
}