Edit live campaign budget

Changes the daily or lifetime budget of a campaign or ad set that is already live, and pushes the change straight to the ad platform. amount is in cents (minimum 100). Returns 409 for a node that is still a draft; draft budgets are changed through the settings endpoint.

POST

/v1/brands/{brandId}/launches/{launchId}/nodes/{nodeId}/live-budget

Authorization

bearerAuth

headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

Path Parameters

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

launchId*string

The campaign launch (batch) id.

nodeId*string

ID of the live campaign or ad set node to edit

Length1 <= length

Header Parameters

Request Body

application/json

body

level*string

Level of the node. Budget cannot be edited on an ad.

Value in"CAMPAIGN""ADSET"

budgetType*string

Whether to set the daily or lifetime budget.

Value in"daily""lifetime"

amount*integer

New budget in CENTS (5000 = $50.00). Minimum 100 ($1.00). If the user said "$50", pass 5000.

Range100 <= value <= 10000000

Response Body

Edit live campaign budget

application/json

response

updated*string

level*string

Value in"CAMPAIGN""ADSET"

budgetType*string

Value in"daily""lifetime"

amount*number

metaId*string

nodeName?string|null

previousBudget?|null

currencyCode?string|null

[key: string]?unknown

curl -X POST "https://example.com/v1/brands/0/launches/string/nodes/string/live-budget" \  -H "Authorization: Bearer koast_sk_..." \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "level": "CAMPAIGN",    "budgetType": "daily",    "amount": 100  }'

{  "updated": "string",  "level": "CAMPAIGN",  "budgetType": "daily",  "amount": 0,  "metaId": "string",  "nodeName": "string",  "previousBudget": {    "type": "daily",    "amountMinorUnits": 0,    "property1": null,    "property2": null  },  "currencyCode": "string",  "property1": null,  "property2": null}

Required scope: publish. CLI: koast edit-live-campaign, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.