Delete batch or pipeline card
Permanently deletes the launch (or pipeline card) and every campaign, ad set and ad it holds in Koast. Anything already published to the ad platform is untouched and keeps running and spending; pause it first if that is the intent.
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.
Delete batch or pipeline card
application/json- response
deleted*stringThe id that was deleted.
[key: string]?unknowncurl -X DELETE "https://example.com/v1/brands/0/launches/string" \ -H "Authorization: Bearer koast_sk_..."{ "deleted": "string", "property1": null, "property2": null}Required scope: write. CLI: koast delete-batch, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.
Import live campaign
Wraps a campaign that exists on the ad platform but not in Koast (providerCampaignId) in a new launch, so it can be reported on and extended with new ad sets and ads that publish into the same campaign. Idempotent: if a launch already wraps that campaign, its campaignLaunchId is returned with alreadyExisted: true.
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.