Skip to content
Skip to main content
DELETE
https://api.us.nylas.com/v3/grants/{grantId}

Delete a grant

Delete an existing grant by ID. You cannot re-authenticate the deleted grant. If you try to re-authenticate it, Nylas creates a new grant instead.

Before deleting a grant, consider whether re-authentication is the better option. Deleting a grant is permanent: object IDs may change (especially for IMAP providers), sync state resets, and tracking links break. See Handling expired grants for details.

Works with an API key or an IAM API key with the grants.delete permission.

Parameters

Path parameters

grantId*string

Responses

request_id*string

ID of the request.

Example: "5967ca40-a2d8-4ee0-a0e0-6f18ace39a90"
DELETEhttps://api.us.nylas.com/v3/grants/{grantId}

Find your API key in the Nylas Dashboard under API Keys in your application settings.

grantIdrequiredstring