Segments

Bulk archive segments

Archive up to 50 segments in one request by setting status: archived. Deliberately DIVERGES from DELETE /v1/segments/{id}: the single-segment DELETE permanently removes the segment (sets deleted: true behind a SEGMENT_IN_USE impact gate, dropping it out of every referencing audience's composition), while bulk archive only changes status — archived segments remain fully resolvable by audiences that reference them, so composition integrity is preserved and no impact gate is needed. Fully reversible via PATCH {status: active} (single or bulk). Best-effort per segment: not-found/deleted ids are reported in the failed array; already-archived segments count as success (idempotent). Requires 'creator' scope.

delete/v1/segments/bulk

Request

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

Request body

segment_idsstring[] required

IDs of segments to archive (1-50).

Response

Bulk archive processed. Per-segment failures, if any, are listed in failed.

archivedinteger required

Number of segments now archived (includes already-archived segments, which are idempotent successes).

Changes

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