---
title: "Revokes an invitation"
method: POST
path: "/invitations/{invitation_id}/revoke"
tags: ["Invitations"]
---

# Revokes an invitation

`POST /invitations/{invitation_id}/revoke`

Revokes the given invitation.
Revoking an invitation will prevent the user from using the invitation link that was sent to them.
However, it doesn't prevent the user from signing up if they follow the sign up flow.
Only active (i.e. non-revoked) invitations can be revoked.

## Path parameters

- `invitation_id` string, required

## Response `200`

Success

- object
  - `object` 'invitation', required
  - `id` string, required
  - `email_address` string, email, required
  - `public_metadata` object, required
  - `revoked` true
  - `status` 'revoked', required
  - `url` string
  - `expires_at` integer, nullable — Unix timestamp of expiration.
  - `created_at` integer, required — Unix timestamp of creation.
  - `updated_at` integer, required — Unix timestamp of last update.

## Other responses

- `400` — Request was not successful
- `404` — Resource not found

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/cf036e7951d3/schema)