---
title: "Delete a grant"
method: DELETE
path: "/v3/grants/{grantId}"
tags: ["Manage Grants"]
---

# Delete a grant

`DELETE /v3/grants/{grantId}`

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](https://developer.nylas.com/docs/dev-guide/best-practices/grant-lifecycle/) for details.

## Path parameters

- `grantId` string, required

## Response `200`

Delete Succeeded

- object
  - `request_id` string, required — ID of the request.

## Other responses

- `401` — Not Authenticated
- `404` — Not Found

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)