Manage Grants

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.

delete/v3/grants/{grantId}

Path parameters

grantIdstring required
Example:5967ca40-a2d8-4ee0-a0e0-6f18ace39a90

Response

Delete Succeeded

request_idstring required

ID of the request.

Example response

{
  "request_id": "5967ca40-a2d8-4ee0-a0e0-6f18ace39a90"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.