v1

latestOpenAPI 3.0.12026-07-26152262362.2 KB
Users

Cancel invite

Marks the invite as Cancelled and invalidates the invite token so any outstanding email links stop working. The invite document is retained (soft cancel) — the user row remains visible in GET /iam/v1/users with inviteStatus: Cancelled. Use DELETE /iam/v1/users/{id} to fully remove the record.

Returns 404 if no invite exists for the given ID, and 409 if the invite is already cancelled.

Requires usersManager permission.

post/iam/v1/users/{id}/actions/cancel

Path parameters

idstring required

The unique ID of the invited user.

Query parameters

dryRunboolean

If true, validates and simulates the operation without committing changes. The response shape is identical to a real execution.

Headers

Idempotency-Keystring required

Client-generated idempotency key (UUID v4 or ULID recommended, max 255 characters). Re-submitting the same key with the same request returns the cached response without re-executing side effects. The server retains the key for at least 24 hours.

Request body

object required

Response

OK - Invite cancelled.

messagestring required

Success message

inviteIdstring required

The invite document ID.