cURL
Destinations
Bulk Delete Destinations
Delete several destinations at once with a single request.
POST
cURL
Deletes several destinations in one call. The request body takes a list of pipeline slugs, not destination IDs.
This endpoint uses
POST rather than DELETE because OpenAPI does not document a request body on DELETE. It deletes — it does not create anything.Request body
Response
Returns200 OK with a summary of what the action did, rather than the deleted objects.
Example
Python example: delete every destination carrying a given tag
Authentication
This endpoint requires an API key in thex-api-key header. MCP tokens cannot delete resources and are rejected with 403 Forbidden.
Related
- Delete Destination — remove a single destination.
- List Destinations — collect the slugs to send.
Authorizations
API Key authentication. Format: 'x-api-key: api_key'
Body
Slugs of the destinations to act on.
Response
200 - application/json
The summary a bulk action returns instead of the affected objects.
Human-readable summary of what the bulk action did.