Delete batch or pipeline card
Permanently delete a Koast batch (campaign launch) or pipeline card, together with the campaigns, ad sets and ads it holds in the Koast tree.
Tool name: delete-batch.
Permanently delete a Koast batch (campaign launch) or pipeline card, together with the campaigns, ad sets and ads it holds in the Koast tree. A pipeline card IS a batch, so this removes either. This does NOT touch anything on the ad platform: already-published campaigns keep running and keep spending, pause them with updateNode first if that is the intent. Irreversible. WRITE, destructive.
When to use
Remove a draft batch or pipeline card the user no longer wants, including leftovers from a test run. Confirm with the user first, and say plainly that live campaigns already published from the batch keep running.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | Yes |
| Idempotent | Yes |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
campaignLaunchId | string | Yes | The batch or pipeline card id to delete. |
brandId | string | No | Brand that owns the batch. Defaults to the brand in context. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
deleted | string | Yes | The id that was deleted. |
REST equivalent
DELETE /v1/brands/{brandId}/launches/{launchId}, Delete batch or pipeline card. CLI: koast delete-batch.