Revoke a pending invitation (admin)

POST

/v1/admin/orgs/{org_id}/invitations/{invitation_id}/revoke

• Production
• Local

Authorizations

• ClerkSession

Parameters

Path Parameters

org_id

required

string

invitation_id

required

string

Responses

200

Revoked.

An org invitation. token is the raw secret returned ONCE on a fresh create (empty when an existing pending invitation was reused, or on accept/revoke).

object

id

required

string

org_id

required

string

email

required

string

role

required

string

Allowed values: owner admin member viewer billing

status

required

string

Allowed values: pending accepted revoked expired

token_prefix

required

string

token

Raw invitation token; present only on a fresh create.

string

expires_at

required

string format: date-time

created_at

required

string format: date-time

401

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

403

Authenticated but lacking the required scope, or out of quota.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope

404

Resource not found.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope