POST/organizations/{organization_id}/invitations/{invitation_id}/revoke

Revoke a pending organization invitation

Use this request to revoke a previously issued organization invitation. Revoking an organization invitation makes it invalid; the invited user will no longer be able to join the organization with the revoked invitation. Only organization invitations with "pending" status can be revoked. The request accepts the requesting_user_id parameter to specify the user which revokes the invitation. Only users with "admin" role can revoke invitations.

IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 1 body field

organization_idstringrequired

The organization ID.

invitation_idstringrequired

The organization invitation ID.

requesting_user_idstringoptional

The ID of the user that revokes the invitation. Must be an administrator in the organization.

4 status codes

200An organization invitation

objectstringrequired

String representing the object's type. Objects of the same type share the same value.

Allowed:organization_invitation

idstringrequired

email_addressstringrequired

rolestringrequired

role_namestringrequired

organization_idstringoptional

inviter_idstringrequired

public_inviter_dataobjectrequired

An organization inviter's public user data

statusstringoptional

public_metadataobjectrequired

private_metadataobjectoptional

urlstringrequired

expires_atintegerrequired

Unix timestamp of expiration.

created_atintegerrequired

Unix timestamp of creation.

updated_atintegerrequired

Unix timestamp of last update.

400Request was not successful

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

403Authorization invalid

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

404Resource not found

errorsarray<object>required

metaobjectoptional

clerk_trace_idstringoptional

Error handling

A 400 is returned: Request was not successful. A 403 is returned: Authorization invalid. A 404 is returned: Resource not found.

import { Client } from "@octridev/clerk";

const client = new Client({
  baseUrl: "https://api.clerk.com/v1",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.revoke.create({
  organizationId: "9b2f1c10-7a3e-4d54-8c2a-1f6b9e0d4a21",
  invitationId: "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  requestingUserId: "c0a80123-4567-89ab-cdef-0123456789ab",
});

{
  "object": "organization_invitation",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email_address": "user@example.com",
  "role": "administrator",
  "role_name": "Example Name",
  "organization_id": "550e8400-e29b-41d4-a716-446655440000",
  "inviter_id": "550e8400-e29b-41d4-a716-446655440000",
  "public_inviter_data": {
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "first_name": "Example Name",
    "last_name": "Example Name",
    "image_url": "https://example.com",
    "has_image": true,
    "identifier": "example_value"
  },
  "status": "active",
  "url": "https://example.com",
  "expires_at": 1,
  "created_at": 1,
  "updated_at": "2026-01-15T09:00:00Z"
}

Request

Response

Errors