> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sublay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Revoke workspace invite

> Revoke a pending workspace invitation

## Overview

`useRevokeWorkspaceInvite` returns a callable that marks a pending [invitation](/v8/data-models/workspace-invitation) `revoked`. Fires `workspace.invite.revoked`.

**Authorization:** capability-gated. Requires the `invite` capability on the workspace (owners hold it implicitly) — the same gate as creating and listing invites.

<Note>
  The underlying route is a verb-suffixed **`POST /workspaces/:id/invites/:inviteId/revoke`**, not a `DELETE`. The hook handles this for you; it is worth knowing if you are comparing against the [API reference](/v8/api-reference/workspaces/invitations/revoke-invite).
</Note>

## Usage Example

```tsx theme={null}
import {
  useFetchWorkspaceInvites,
  useRevokeWorkspaceInvite,
} from "@sublay/react-js";

function InviteRow({
  workspaceId,
  inviteId,
}: {
  workspaceId: string;
  inviteId: string;
}) {
  const revokeWorkspaceInvite = useRevokeWorkspaceInvite();
  const fetchWorkspaceInvites = useFetchWorkspaceInvites();

  const handleRevoke = async () => {
    await revokeWorkspaceInvite({ workspaceId, inviteId });
    await fetchWorkspaceInvites({ workspaceId }); // refresh the outbox
  };

  return <button onClick={handleRevoke}>Revoke</button>;
}
```

## Parameters

<ParamField path="workspaceId" type="string" required>
  The workspace UUID.
</ParamField>

<ParamField path="inviteId" type="string" required>
  The invitation UUID.
</ParamField>

## Returns

`{ success: boolean }`.

## Error codes

| Code | Status | Meaning |
| - | - | - |
| `workspace/unauthorized` | 403 | You lack the `invite` capability on this workspace. |
| `workspace/invite-not-found` | 404 | No such invitation on this workspace. |

## Related

* [`useFetchWorkspaceInvites`](/v8/hooks/workspaces/use-fetch-workspace-invites) — list what there is to revoke
* [`useResendWorkspaceInvite`](/v8/hooks/workspaces/use-resend-workspace-invite)
* [Revoke Invite API](/v8/api-reference/workspaces/invitations/revoke-invite)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.