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

# Delete a grant setting

`DELETE /v3/grants/{grant_id}/settings/{setting_name}`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/grants/{grant_id}/settings/{setting_name}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nylas/apis/nylas-api/docs/v3/grants/:grant_id/settings/:setting_name/delete.ts> (a function with typed inputs; its response is checked against the schema)

Removes the setting and returns the grant to that setting's default behavior.
[Get grant settings](/docs/reference/api/manage-grants/get_grant_settings/) describes each
setting's default.

Returns `200` whether or not the setting had a value, so retrying the request is safe.

## Response `200`

Delete Succeeded

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

## Other responses

- `401`: Not Authenticated
- `404`: Not Found

## Changes

- **2026-10-27** `d8ee467a1e7e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/grants/:grant_id/settings/:setting_name/delete.md)

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) - [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nylas/apis/nylas-api/revisions/7782a3e3ab70?raw)