Skip to main content
PATCH
Update Campaign
Requires a Labs OAuth user access token with the super_user role and Editor or higher workspace access. API keys are not accepted for this endpoint. See authentication. You can update name, concurrency, time slots, and retry config. Updates are only allowed on campaigns in draft or paused status — pause the campaign first if it is currently running.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Path Parameters

campaign_id
integer
required

Body

application/json
circuit_breaker
CircuitBreakerConfigRequest · object | null
max_concurrency
integer | null
Required range: 1 <= x <= 100
name
string | null
Required string length: 1 - 255
retry_config
RetryConfigRequest · object | null
schedule_config
ScheduleConfigRequest · object | null

Response

Successful Response

completed_at
string<date-time> | null
required
created_at
string<date-time>
required
failed_rows
integer
required
id
integer
required
name
string
required
processed_rows
integer
required
retry_config
RetryConfigResponse · object
required
source_id
string
required
source_type
string
required
started_at
string<date-time> | null
required
state
string
required
total_rows
integer | null
required
workflow_id
integer
required
workflow_name
string
required
circuit_breaker
CircuitBreakerConfigResponse · object | null
executed_count
integer
default:0
logs
CampaignLogEntryResponse · object[]
max_concurrency
integer | null
parent_campaign_id
integer | null
redialed_campaign_id
integer | null
schedule_config
ScheduleConfigResponse · object | null
telephony_configuration_id
integer | null
telephony_configuration_name
string | null
total_queued_count
integer
default:0