API referenceAudiences

Remove a contact from an audience

DELETE
/v1/audiences/{id}/members/{contact_id}

Idempotent — removing a non-member (or an already-removed one) still returns 200 deleted:true.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <key>. Looked up by SHA-256 hash (email_core::sha256_hex) against api_keys.hash; revoked keys and keys belonging to a suspended tenant are rejected. See the top-level Authentication section for permission levels.

Path Parameters

id*string
contact_id*string

Response Body

Removed (or was already not a member).

application/json
  1. response
deleted?true
Value intrue
audience_id?string
contact_id?string
curl -X DELETE "https://example.com/v1/audiences/string/members/string"
{  "deleted": true,  "audience_id": "string",  "contact_id": "string"}