Skip to main content
POST
Stop a wallet campaign and refund unspent budget

Authorizations

x-api-key
string
header
required

Pass your Soundlink sk_* API key in the x-api-key header. Keys can carry explicit scopes (for example campaigns:read, metrics:read, videos:write) enforced by the backend.

Deprecated, retiring 2026-08-17 — migrate to Authorization: Bearer sk_... (see apiKeyBearerAuth) before then.

Headers

Idempotency-Key
string
required

A unique string identifying this request, used to safely retry write operations (create, stop, budget increase/decrease) without repeating side effects. Required on every request that references this parameter. Reusing this key with an unchanged request body replays the original response; reusing it with a different body returns 409 idempotency_key_conflict. Keys are honored for 24 hours.

Required string length: 1 - 255

Path Parameters

campaignId
string
required

Campaign identifier (UUID)

Response

Campaign stopped (or already stopped)

data
object
required
meta
object
required