Get settings
Returns the current settings (budget, targeting, schedule, placements, optimization) of one node (nodeId and nodeType) or of up to 60 nodes at once via nodes.
bearerAuthAuthorizationBearer <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.
brandId*integerThe brand the request acts on. Every brand-scoped resource lives under its brand.
launchId*stringThe campaign launch (batch) id.
nodeId?stringID of the node (single-node form; omit when using nodes)
1 <= lengthnodeType?stringType of the node (single-node form)
"campaign""adset""ad"Get settings
application/json- response
[key: string]?unknowncurl -X GET "https://example.com/v1/brands/0/launches/string/settings" \ -H "Authorization: Bearer koast_sk_..."{ "property1": null, "property2": null}Required scope: read. CLI: koast get-settings, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.
Launch campaign
Publishes the launch to the ad platform. Without confirm: true nothing is published: the launch is validated and a preview of its campaigns, ad sets, ads and budgets is returned (mode: preview). With confirm: true the publish jobs are queued and mode: publish is returned. A launch that fails validation (in either mode) answers 400 validation_failed with the message Launch validation failed: N issues. and one { field, message } per issue in details, where field names the node (campaigns[<id>], adSets[<id>] or ads[<id>]) and, when known, its setting (ads[<id>].creative).
Update settings
Applies settings (dot-notation paths) to every node in nodeIds, all of the same nodeType. The request is atomic: every path lands or none does, and a rejection names each path and the reason. budget.dailyAmount and budget.lifetimeAmount are in cents; bid amounts and ad set spend limits are in dollars. Change campaign budget optimization with budgetStrategy (CBO or ABO). Concurrent writes to the same launch return 409.