Update a dialer campaign
Partially updates a campaign (COALESCE semantics — omitted fields are left unchanged). Re-runs the same anti-spoofing / voice-agent-existence / recording-consent gates as create on any field that is present. Activating (status: 'active') is blocked by the org-wide compliance emergency stop, a missing resolvable voice application, or a prior recording-consent gap. An ‘aborted’ campaign cannot transition to any other status. Requires the dialer:write scope.
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Path Parameters
Campaign id.
Body
Campaign display name.
Target status: active, paused, completed, or aborted. Cannot transition away from 'aborted'.
0.8-3.0.
FCC abandon-rate ceiling fraction.
5-120.
Must be owned by this org.
Enabling requires recording_consent_acknowledged=true in the same request unless already acknowledged.
'human' or 'voice_agent'.
Null clears the agent; a string must reference an existing agent.
1-200.