<Intro>

<EndpointHeader />

<Description>

Removes up to 1,000 contacts from an audience. Contacts that are not members are skipped. If any contact ID does not exist in the workspace, the whole request fails with a validation error and no memberships are removed. The contacts themselves are not deleted and remain members of any other audiences.

</Description>

</Intro>

<Parameters in="path">

<Parameter name="audience_id" type="string">

<Description>

ID of the audience to remove contacts from (`adn_`-prefixed).

</Description>

</Parameter>

</Parameters>

<Payload kind="request">

<Field name="contact_ids" type="array of string" required>

<Description>

Contacts to remove from the audience. Removing a contact that is not a member has no effect; duplicate IDs in the list are collapsed. If any ID does not exist in the workspace, the whole request fails with a validation error and no memberships are removed.

</Description>

</Field>

</Payload>