Audiences

Bulk update audiences

Apply set_logic, segment add/remove, or status changes to multiple audiences in a single request. Audiences are subtype-agnostic composition wrappers, so this applies uniformly regardless of which segment subtypes (filter, matched, similarity, propensity) they compose. Fail-closed ownership validation — any unauthorized ID returns 403 before any writes. Max 50 audiences per call. Returns 207 for partial success. Requires 'creator' scope.

patch/v1/audiences/bulk

Request

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

Request body

audience_idsstring[] required

IDs of audiences to update (1–50).

set_logic'union' | 'intersection'

New set_logic to apply to all specified audiences.

add_segment_idstring

Segment ID to append to the included list of each audience.

remove_segment_idstring

Segment ID to remove from the included list of each audience.

status'archived' | 'active'

Valid user-settable transitions, applied to every audience in audience_ids: archived — soft-deletes the audience; excluded from list results by default. active — restores a previously archived audience back to active; rejected with 400 (INVALID_STATUS_TRANSITION) if the current status is not archived. System-managed statuses (pending, expired, failed) cannot be set via this endpoint and are rejected with 400.

Response

All audiences updated.

updatedinteger

Changes

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