Skip to main content
DELETE
JavaScript
Deleting an entitlement is a soft-delete that hides existing grants from the Customer Portal. It does not revoke platform-side access:
  • Grants linked to the entitlement remain in the database and keep their current status.
  • Discord roles, GitHub collaborator access, Notion access, Telegram membership, license keys, and digital file URLs stay valid.
  • No entitlement_grant.revoked webhook is emitted, and revoked_at / revocation_reason are not set.
Customers stop seeing these grants in their Customer Portal, but their access on the underlying platform continues until the subscription/payment lifecycle revokes it (cancellation, refund) or you revoke each grant manually via DELETE /entitlements/{id}/grants/{grant_id}.If you need to fully cut off access, revoke the grants first, then delete the entitlement.

Authorizations

Authorization
string
header
required

Send your API key as a bearer token: Authorization: Bearer <api_key>. A test mode key starts with dodo_test_, for example dodo_test_AbCd1234EfGh5678.<secret>. A live mode key starts with dodo_live_. Use a test mode key on test.dodopayments.com and a live mode key on live.dodopayments.com. Keys from before these tags have no tag and operate as before.

Path Parameters

id
string
required

Entitlement ID

Response

Entitlement deactivated

Last modified on October 28, 2026