# Cancel an invitation

URL: https://heaven.dev/docs/reference/organizations/invitation-cancel
Updated: 2026-11-21

Withdraw pending organization or team invitations. Organization admins can cancel ordinary invitations and team admins can cancel invitations to their own team. Only the billing owner can withdraw an offer of billing ownership.

`POST /v1/organization/modify`

## Parameters

- `invitation` (string, required): Invitation ID or recipient email address or user ID. A recipient can match more than one pending invitation you have permission to withdraw.
- `organization` (string): Organization name or ID. A credential, named resource or sole membership can select the organization for you.

## Returns

- `data` (object, always present): A canceled invitation.
  - `cancelled` (boolean, always present): True after the invitation was canceled.

## Errors

Each code is explained in full at https://heaven.dev/docs/reference/errors.

| Code | Status | What happened |
|---|---:|---|
| `invalid` | 400 | An input is missing or invalid. |
| `unauthenticated` | 401 | The credential is missing, invalid, expired or revoked. |
| `denied` | 403 | The caller lacks permission for this action. |
| `not_found` | 404 | The resource is absent or inaccessible to this caller. |
| `conflict` | 409 | The request conflicts with the current resource state or an earlier request. |
| `over_capacity` | 409 | The request exceeds a resource or credential allowance. |
| `access_list_full` | 409 | The change would exceed the access-list allowance. |
| `payment_required` | 402 | Payment or credit is required. |
| `rate_limited` | 429 | The caller's request rate exceeds its limit. |
| `busy` | 429 | Too much work is in progress to accept this request. |
| `unknown` | 503 | The outcome is unconfirmed; a change may have happened. |
| `unavailable` | 503 | The service or requested feature is unavailable. |

## Notes

- CLI: `heaven login` with `HEAVEN_API_KEY` unset. MCP: Heaven sign-in. cURL: `HEAVEN_SIGN_IN_KEY` from approved device sign-in (`POST /v1/auth/create`).
- A key limited to a command list cannot run this command.

## Examples

```sh tab="heaven CLI"
heaven organization invitation cancel INVITATION
  [--organization ORGANIZATION]
```

```sh tab="SSH"
ssh cli@heaven.dev organization invitation cancel INVITATION
  [--organization ORGANIZATION]
```

```sh tab="cURL"
curl https://heaven.dev/v1/organization/modify \
  -H "Authorization: Bearer $HEAVEN_SIGN_IN_KEY" \
  --json '{"action": "invitation cancel", "invitation": "ada@example.com"}'
```

```json tab="MCP"
{ "tool": "organization_invitation_cancel",
  "arguments": { "invitation": "ada@example.com" } }
```

Response:

```json title="Response excerpt"
{
  "version": 1,
  "data": {
    "cancelled": true
  }
}
```
