PUT
/
workflow
/
call
/
{workflowId}
cURL
curl --request PUT \
  --url https://api.subverseai.com/api/workflow/call/{workflowId} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "customer_number": "+912298765432",
  "customer_details": {
    "email": "[email protected]",
    "name": "John Doe",
    "id": "JD75816540"
  },
  "bot_number": "+912298765432",
  "use_case": "test_case",
  "schedule_time": "2025-01-22T08:14:57Z",
  "options": {
    "transcriptLanguage": "hi",
    "allowedOverallInterruptions": "True",
    "allowedInterruptionsInitially": "False",
    "ttsLanguage": "hi",
    "voiceId": "IvLWq57RKibBrqZGpQrC",
    "speed": "2",
    "transferNumber": "+912298765432",
    "communicationMethod": "two_way",
    "dtmfEnabled": "False",
    "initialMessage": "Hi, ${name} how can I assist you today?",
    "additionalContext": "The caller is asking about a refund request submitted yesterday."
  },
  "no_of_retries": 1,
  "retry_after_in_hrs": 1,
  "start_working_hour": "09:00",
  "end_working_hour": "20:00",
  "timezone": "Asia/Kolkata"
}'
{
  "responseCode": 200,
  "message": "Workflow call details updated successfully",
  "data": null
}

Authorizations

​
x-api-key
string
header
required

Authentication header containing API key from SubVerse dashboard.

Path Parameters

​
workflowId
string
required

Unique identifier of the workflow.

Body

application/json
​
customer_number
string
required

User's phone number. Must be a valid phone number with country code, with or without '+' prefix.

​
customer_details
object

User's details to be used in the call, use them in voice agent initial and system prompt as ${variable_name} format. These will be replaced by actual value of the variables.

​
use_case
string

Use case to be used for the call, find it in Voice Agents sections in dashboard. Default value: use case selected in the workflow.

​
bot_number
string

Voice agent phone number used to place call. Must be a valid phone number with country code, with or without '+' prefix. Default value: bot number selected in the workflow.

​
schedule_time
string

Schedule customer's call at a specific future time. Follow ISO date format (YYYY-MM-DDTHH:MM:SSZ). Default value: current time, to trigger the call immediately.

​
options
object

Default values as defined in the Voice Agents section in dashboard. Use this if you want to override those options. E.g. if you want to change the language, voice, initial prompt, etc.

​
no_of_retries
number

Number of retries if call failed if provided

​
retry_after_in_hrs
number

Retry at interval (in hrs) if provided

​
start_working_hour
string

24 hour format (HH:MM). If provided call made before start hours will rescheduled at start hour of the day.

​
end_working_hour
string

24 hour format (HH:MM). If provided call made after end hours will rescheduled at start hour of next day.

​
timezone
string

Call between start working hour and end working hour in timezone if provided [Default: Asia/Kolkata]

Response

200 - application/json

Returns error or success response

​
responseCode
integer
required

Always returns 200 value, with error or success response details in message.

​
message
string
required

Success or error message with description.

​
data
any

Additional details if available.