---
title: "Revoke invitation"
method: POST
path: "/api-regulated/v1/invitations/{invitationId}/revoke"
tags: ["Invitation"]
---

# Revoke invitation

`POST /api-regulated/v1/invitations/{invitationId}/revoke`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/invitations/{invitationId}/revoke`
- Auth: OAuth 2 (implicit, authorization URL `https://auth.currencyguard.com/oauth2/authorize`, scopes: `regulated.invitations.canManageInvitation`)

Revokes an invitation created by this regulated user by changing its status to REVOKED.

**Required entitlement:** `regulated.invitations.canManageInvitation`  
_Entitles the regulated user to manage and modify invitations within their scope of responsibility_

## Path parameters

- `invitationId` string, uuid, required

## Response `204`

Invitation revoked successfully

## Other responses

- `400`: Invalid ID — [`http/malformed-request`](/problems/http/malformed-request/)
- `401`: Not authenticated — [`security/authentication-failed`](/problems/security/authentication-failed/)
- `403`: Not authorized - invitation not owned by user — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `404`: Invitation not found — [`http/resource-not-found`](/problems/http/resource-not-found/)
- `422`: Invalid invitation state for revocation — [`validation/validation-error`](/problems/validation/validation-error/)
- `500`: Server error — [`server/internal-error`](/problems/server/internal-error/)

---

[API](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external.md) · [All operations](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/revisions/a1f3f854190d?raw)