Segments

Bulk hard-delete segments

Permanently delete up to 50 segments in one request — the bulk counterpart of DELETE /v1/segments/{id} (sets deleted: true, dropping each segment out of every referencing audience's composition). Unlike the single-segment DELETE, there is no confirm_impact bypass here: a segment referenced by 1+ audiences is always skipped (never force-deleted) and reported back in skipped, since a bulk action has no per-segment confirmation UI to make an informed override decision. Delete the segment individually via DELETE /v1/segments/{id}?confirm_impact=true to force it. Best-effort per segment: not-found/already-deleted ids are reported in failed. Requires 'creator' scope.

delete/v1/segments/bulk-delete

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/segments/bulk-delete
  • Auth: HTTP bearer

Request body

segment_idsstring[] required

IDs of segments to delete (1-50).

Response

Bulk delete processed. In-use segments and per-segment failures, if any, are listed in skipped/failed respectively.

deletedinteger required

Number of segments permanently deleted.

Changes

No recorded changes to this operation across all 1 revision of this API.