foliot docs

API reference / Workspaces / Cancel a pending invitation

Cancel a pending invitation

DELETE/workspaces/{workspaceId}/invitations/{invitationId}

Authenticate with an operator token or a signed-in Foliot Console session.

Removes the invitation, and with it the address; the person can no longer join through it. If the email service sent one for it and no other workspace is still waiting on the same address, that email’s link is revoked too, as a best effort: the cancel stands even if the email service cannot be reached. An owner of the workspace, or an operator token. 404 if there is no such pending invitation in this workspace (one that was accepted, cancelled or has expired is gone). Someone who has already joined is not removed by this: use the member routes.

Path parameters

workspaceId
string (uuid)
REQUIRED

The workspace.

invitationId
string (uuid)
REQUIRED

The invitation's id, from the invitation list.

Responses

204 no body No Content
400 Error Invalid request.
401 Error Missing, malformed or unknown bearer token.
403 Error The token is valid but not permitted on this route.
404 Error No such resource.
503 Error A dependency this route needs is unreachable.