Delete Entitlement - Dodo Payments Documentation

DELETE

entitlements

{id}

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

string

required

Entitlement ID

Response

Entitlement deactivated

Last modified on June 3, 2026

Upload FileUpload a file to a Digital Files entitlement. Files are streamed to storage; the maximum size is 500 MiB. The returned file ID is appended to the entitlement's digital_file_ids list.

⌘I

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');