TAtalkdesk
Retail Experience Cloud Bridge

Revoke a suppression entry

Changed on

Revokes a suppression entry — a soft revoke, never a hard delete. The entry stays in the system (status becomes REVOKED), but is excluded from GET .../suppressions?status=ACTIVE.

A subsequent POST .../suppressions for the same customer/domain/brand revives this same entry (status back to ACTIVE) rather than creating a new one.

Revoking an already-REVOKED entry is a no-op — it returns the entry unchanged, not an error.

delete/erc/ecommerce/customers/{customer_id}/suppressions/{suppression_id}

Request

  • Base URL
    https://api.talkdeskapp.com
  • URL
    https://api.talkdeskapp.com/erc/ecommerce/customers/{customer_id}/suppressions/{suppression_id}
  • Auth
    OAuth 2
    Authorization code: https://{account_name}.talkdeskid.com/oauth/authorize
    Token URL: https://{account_name}.talkdeskid.com/oauth/token scopes: erc-ecommerce-customers:write

Path parameters

customer_idstring required
Example:7710396907579

The customer ID

suppression_idstring required
Example:68b1f2a1c2a4a90012e4f1a2

The suppression entry ID, as returned by POST/GET .../suppressions

Response

The suppression entry was revoked.

idstring required

The unique identifier of the suppression entry.

domainstring required
scope'PER_CUSTOMER' required
customer_idstring required
reason_codestring required
status'ACTIVE' | 'REVOKED' required

ACTIVE entries currently block outbound contact. REVOKED entries are kept for audit history but no longer count as active — see DELETE .../suppressions/{suppression_id}. There's at most one entry per (domain, customer_id, brand) at a time — creating a new one for a customer that already has a REVOKED (or naturally expired) entry revives that same entry back to ACTIVE instead of adding a second row.

created_atstring date-time required
expires_atstring date-time

Optional expiration. Absent for a permanent suppression entry.

updated_atstring date-time required

Example response

{
  "id": "68b1f2a1c2a4a90012e4f1a2",
  "domain": "recall_management",
  "scope": "PER_CUSTOMER",
  "customer_id": "7710396907579",
  "reason_code": "OPT_OUT",
  "status": "ACTIVE",
  "created_at": "2026-08-27T10:00:00Z",
  "expires_at": "2026-11-27T10:00:00Z",
  "updated_at": "2026-08-27T10:00:00Z"
}

Changes