Skip to main content
PATCH
Update campaign (attach/detach list)

Authorizations

Authorization
string
header
required

API key authentication.

X-User-ID
string
header
required

Required user id for API key requests.

Path Parameters

campaign_id
string
required

Body

application/json

Update campaign fields only. Use action endpoints for start/pause/save_draft.

name
string | null
scheduleStartTime
string | null
scheduleEndTime
string | null
max_concurrency
integer | null
Required range: 1 <= x <= 200
retry_policy
Retry Policy · object | null
speech_settings
SpeechSettings · object | null
campaign_context
string | null
opening_message_template
string | null
use_returning_greeting
boolean | null
use_short_term_summaries
boolean | null
short_term_summaries_limit
integer | null
machine_detection_timeout_seconds
integer | null
Required range: 3 <= x <= 60
recipient_list_id
string | null
recipients
RecipientPayload · object[] | null

Response

Successful Response

id
string
required
name
string
required
assistant_id
string
required
channel
string
required
phone_number_id
string
required
status
string
required

Read-only. Server-managed: draft | running | paused | completed

max_concurrency
integer
required
retry_policy
Retry Policy · object
required
speech_settings
SpeechSettings · object
required
assistant_name
string | null
caller_id_number
string | null
schedule_start_time
string | null
schedule_end_time
string | null
campaign_context
string | null
opening_message_template
string | null
use_returning_greeting
boolean
default:false
use_short_term_summaries
boolean
default:false
short_term_summaries_limit
integer | null
machine_detection_timeout_seconds
integer | null
recipient_list_id
string | null
recipient_list_name
string | null
recipient_list_row_count
integer | null
counts
Counts · object | null
created_at
string | null
updated_at
string | null