ZEzernio
Creator Campaigns

Raise creator campaign budget

Changed on

Raises the budget of a campaign that is draft, active or paused.

Only the budget changes. The pay terms stay as creators joined them, which PATCH refuses to change once the campaign is live.

  • The new budgetCents must be above the current budget, otherwise 400 invalid_field_value.
  • When it is also above what the campaign has spent, budgetExhaustedAt is cleared and earnings that stopped at the old budget resume.
  • A closed campaign answers 409 invalid_resource_state.
post/v1/creator-campaigns/{campaignId}/budget

Request

  • Base URL
    https://zernio.com/api
  • URL
    https://zernio.com/api/v1/creator-campaigns/{campaignId}/budget
  • Auth
    HTTP bearer

Path parameters

campaignIdstring required

Campaign ID.

Headers

Idempotency-Keystring

Optional client-generated unique key (e.g. a UUID) that makes retries safe.

  • Same key + same body: replays the original response.
  • Same key + different body: 422.
  • Key still processing: 409.

A request cut off mid-handler (e.g. by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.

Request body

budgetCentsinteger required

The new total budget in cents.

Response

Budget raised

Example response

{
  "campaign": {
    "kind": "clipping",
    "currency": "usd"
  }
}

Changes

  • c319eb5d95b6Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • 172499a6a5e9Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status