---
title: "Revoke every brokered grant for a deployment (internal)"
method: POST
path: "/onprem/v1/oauth/broker/grants/revoke"
tags: ["onprem"]
---

# Revoke every brokered grant for a deployment (internal)

`POST /onprem/v1/oauth/broker/grants/revoke`

## Request

- Base URL: `https://api.definite.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.definite.app/onprem/v1/oauth/broker/grants/revoke`
- Auth: none declared
- TypeScript: <https://skmtc.dev/definite/apis/defapi/docs/onprem/v1/oauth/broker/grants/revoke/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- RevokeGrantsRequest: POST /onprem/v1/oauth/broker/grants/revoke body (contract §2.6).
  - `deployment_id` string, required: Deployment whose brokered grants should be revoked

## Response `200`

Success

- SuccessResponseDict
  - `success` true, required: Flag for it request was successful
  - `data` object, required: Response data
  - `meta` ResponseMeta
    - `requestId` string: Unique request identifier for tracing
    - `timestamp` string, date-time: Response timestamp (UTC)
    - `durationMs` integer, nullable: Request processing time in milliseconds

## Other responses

- `401`: Auth Invalid Token
- `403`: Forbidden Insufficient Permissions
- `422`: Validation Failed
- `426`: Business Quota Exceeded
- `500`: Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) - [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) - [OpenAPI document](https://skmtc.dev/definite/apis/defapi/revisions/5ea378187147?raw)