Get ad set details
Returns the full details of one ad set in the launch: settings, targeting, budget, schedule, placements, optimization, assets and links, plus its ads.
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.
adsetId*stringID of the ad set to get details for
1 <= lengthGet ad set details
application/json- response
[key: string]?unknowncurl -X GET "https://example.com/v1/brands/0/launches/string/ad-sets/string" \ -H "Authorization: Bearer koast_sk_..."{ "property1": null, "property2": null}Required scope: read. CLI: koast get-adset-details, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.
Add ad set
Adds a draft ad set under the campaign campaignNodeId, optionally applying settings (dot-notation paths, budget amounts in cents) at creation. The response lists the paths that were stored in appliedSettings and those that were not in notApplied. On an imported live campaign, the new ad set is published into that same campaign on the next publish.
Swap creatives
Replaces the creatives on the ad set's ads with creativeIds, in order, keeping each ad's copy. Existing ads are edited in place; extra creatives clone an existing ad, and surplus ads are removed from the Koast tree and listed in removedAdIds.