Skip to main content
Changelogs

Remove changelog subscribers

Removes email addresses from changelog subscribers in bulk.

DELETE
/v2/changelogs/subscribers

Removed subscribers will no longer receive email notifications when new changelogs are published.

Request Body

  • emails - Array of email addresses to remove (required, 1-1000 emails)

Email Handling

  • Emails that don't exist as subscribers are silently ignored
  • Emails are normalized (trimmed, lowercased) before matching

Response

Returns a confirmation with the count of processed emails:

{
  "object": "changelog_subscribers_removal",
  "count": 150
}

Errors

  • 400 - Invalid request (empty emails array, too many emails)
Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Body

application/json
emailsstring[]required

Array of email addresses to remove from changelog subscribers

Required array length: 1 - 1000

Response

application/json

Success

countnumberrequired

Number of email addresses processed

Example: 150
objectenum<string>required

Object type identifier

Available options: changelog_subscribers_removal
Example: changelog_subscribers_removal