Delete Entitlement

Soft-delete an entitlement. Existing grants on the entitlement are unaffected.

DELETE /entitlements/{id}

JavaScript

JavaScript

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

await client.entitlements.delete('ent_jt7jcvI79Xh8eehqgWdcm');

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

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

Entitlement ID

Response

200

Entitlement deactivated