# `bird invitations revoke`

## Usage

```bash
bird invitations revoke <invitation-id> [flags]
```

## Description

Cancels the pending workspace invitation immediately. The invitation link becomes invalid and the invitee cannot use it to join the workspace.

## Procedure

Step 3 of 3 of "Invite a user to a workspace and manage the invitation". Previous: bird invitations get.

## Examples

```bash
bird invitations revoke <id>
```

## Options

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |
| `--response-schema` | Print the fields this command returns, then exit             |

## Related

| Name                                                                | Description                   |
| ------------------------------------------------------------------- | ----------------------------- |
| [`bird invitations create`](/docs/cli/reference/invitations-create) | Create a workspace invitation |
| [`bird invitations get`](/docs/cli/reference/invitations-get)       | Get a workspace invitation    |
| [`bird invitations list`](/docs/cli/reference/invitations-list)     | List workspace invitations    |