# Revoke a grant

Revoke a grant. Identical grants each hold until revoked, so the access lasts until the last of them ends. Revoking the organization's last administrator answers cannot_remove_last_admin.

> Page: https://langwatch.ai/docs/api-reference/grants/revoke-a-grant
> Source: https://github.com/langwatch/langwatch/blob/main/docs/api-reference/grants/revoke-a-grant.mdx
> Index of all pages: https://langwatch.ai/docs/llms.txt

## Endpoint

`DELETE https://app.langwatch.ai/api/v1/grants/{grantId}`

## Authentication

### admin_api_key

Admin API key for organization-level operations (managing projects, API keys). Create one in Settings > API Keys or via POST /api/api-keys. Format: sk-lw-{id}_{secret}.

```json
{"id":"admin_api_key","type":"http","scheme":"bearer"}
```

## Parameters

### grantId (path, required)

```json
{"type":"string","minLength":1,"maxLength":128}
```

## Request example

```bash
curl --request DELETE \
  --url 'https://app.langwatch.ai/api/v1/grants/<grantId>' \
  --header "Authorization: Bearer $LANGWATCH_API_KEY"
```

## Responses

### 200

Success

#### application/json

Schema:

```json
{
  "type": "object",
  "properties": {"id":{"type":"string"},"revoked":{"type":"boolean","const":true}},
  "required": ["id","revoked"],
  "additionalProperties": false
}
```

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.
