---
title: "Revoke a pending invitation so its email link stops working."
method: DELETE
path: "/api/v2/workspaces/{id}/invitations/{invitation_id}"
---

# Revoke a pending invitation so its email link stops working.

`DELETE /api/v2/workspaces/{id}/invitations/{invitation_id}`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/workspaces/{id}/invitations/{invitation_id}`
- Auth: HTTP bearer

Requires a role that manages members and able to manage the invitation's role (403 otherwise). Revoking an already revoked invitation is a no-op (200). An accepted invitation cannot be revoked (409): remove the member on the dashboard instead.

## Path parameters

- `id` string, required
- `invitation_id` string, required

## Response `200`

The invitation, status revoked.

- WorkspaceInvitationObject
  - `data` WorkspaceInvitation
    - `id` string: Opaque invitation ID (inv_...).
    - `email` string: The invited address, lowercased.
    - `role` 'admin' | 'editor' | 'viewer': The role the invitee receives on accepting.
    - `status` 'pending' | 'accepted' | 'revoked' | 'expired': pending until the invitee accepts (accepted), the inviter revokes it (revoked) or seven days pass (expired).
    - `created_at` string, date-time, nullable
    - `expires_at` string, date-time
    - `accepted_at` string, date-time, nullable
    - `revoked_at` string, date-time, nullable

## Other responses

- `403`: The standard error envelope.
- `404`: The standard error envelope.
- `409`: The standard error envelope.

---

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