Skip to content

Delete an audience

DELETE
/content/management/v1/audiences/{id}
curl --request DELETE \
--url https://api.ebitex.io/content/management/v1/audiences/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Deletes an audience no variant refers to. Remove it from every personalized value that names it first; nothing is removed on your behalf.

Key: a management key with content.management.authoring.

id
required
string format: uuid

OK

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired.

payment_required: the organization’s subscription needs attention.

permission_denied: the key’s role lacks content.audiences.manage.

scope_denied: the key lacks this route’s scope. tier_required: the Content Management API needs the Pro plan or above. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Content is not enabled for the organization.

No audience has this id in the key’s environment.

audience_in_use: a variant still refers to the audience; usages lists each as { entityKind, entityId }, where entityKind is component or node. inherited_read_only: the item is inherited from another environment and can only be changed there; sourceEnvironmentId names it.

Rate limit or quota exceeded; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.