Revoke an organization invitation

Request#

DELETE /api/v1/invitations/{invitation}

Requires users:invite. See token permissions. The token creator must remain an active administrator of the token’s organization.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

invitation is the numeric ID of an unaccepted invitation in the token’s organization. Accepted or unavailable invitations return 404.

Query parameters#

This endpoint does not use query parameters.

Request body#

No request body is supported.

Requires Idempotency-Key. Use a unique key for each action and keep it unchanged when retrying. Successful responses are remembered for 24 hours per token. Idempotency and retries.

Example#

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example IDs with values from your organization.

curl --request DELETE "https://my.assetcenter.app/api/v1/invitations/81" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: $(uuidgen)"

Response#

200 OK. Illustrative response; IDs and values will differ.

{
  "data": {
    "invitation_id": 81,
    "revoked": true
  }
}

Behavior and constraints#

Deletes an unaccepted invitation from the token’s organization, including an expired invitation. The acceptance link stops working. Revoking an unexpired invitation releases its reserved user slot. This does not remove an existing member; use Remove an organization user for membership removal.

Retry with the original key to replay success after the invitation has been removed. A new request for that ID returns 404.

Errors#

401 means the customer bearer token is missing, expired, revoked, or invalid. 403 means the token lacks the required permission or its creator is no longer an active administrator. 404 means the requested member or invitation is unavailable in this organization. 422 identifies invalid or unsupported input, plan limits, or a protected membership change. 409 indicates conflicting key reuse or a concurrent organization change. 429 means a rate limit was reached. Error handling and rate limits.