---
title: "Revoke a carrier grant: this reader loses the mailbox"
method: DELETE
path: "/inbox/grants/{grantId}"
tags: ["Inbox"]
---

# Revoke a carrier grant: this reader loses the mailbox

`DELETE /inbox/grants/{grantId}`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/inbox/grants/{grantId}`
- Auth: HTTP bearer

Ownership is the authority: the mailbox owner (or an org manager, for an org mailbox) takes a reader off it. The rows stay (nothing was ever copied); the reader simply stops reaching them.

## Path parameters

- `grantId` string, required

## Response `200`

- GrantRevokeResponseSchema
  - `status` string
  - `revoked` number, required

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)