---
title: "Revoke delegated grant"
method: DELETE
path: "/v2/organizations/{organizationId}/delegated/grants/{grantId}"
tags: ["Delegated agents"]
---

# Revoke delegated grant

`DELETE /v2/organizations/{organizationId}/delegated/grants/{grantId}`

## Request

- Base URL: `https://api.pdfs.build`
- URL: `https://api.pdfs.build/v2/organizations/{organizationId}/delegated/grants/{grantId}`
- Auth: HTTP bearer

Cuts the connection immediately: the grant and every token issued for it are revoked.

## Response `200`

Done.

- Ok
  - `ok` true, required

## Other responses

- `401`: Missing, invalid or expired API key.
- `403`: `admin_required` (the key's owner is not an organization owner/admin), `delegated_plan_required`, `delegated_access_disabled` (the organization has not opted in), or `organization_scope_mismatch`.
- `404`: Unknown grant, or already revoked.
- `502`: The service that owns this resource could not be reached. Safe to retry.

---

[API](https://skmtc.dev/pdfs/apis/pdfs-build-api.md) · [All operations](https://skmtc.dev/pdfs/apis/pdfs-build-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pdfs/apis/pdfs-build-api/revisions/1c7340b9521d?raw)