Cancel a pending invitation (owner)

DELETE

/api/v1/documents/{id}/invitations/{inviteId}

App integration: Owner-only cancellation of a pending email invitation. It cancels the invitation, not a separate existing principal grant. If the recipient already accepted, inspect permissions and use explicit grant removal when intended.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://handwrites.io/oauth/authorize

Token URL: https://handwrites.io/api/oauth/token

Refresh URL: https://handwrites.io/api/oauth/token

Scopes:

permissions:write-Share documents and change or remove access

Path Params

Responses

🟢204

Cancelled.

Headers

This response does not have a body.

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠429TooManyRequests

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/api/v1/documents//invitations/' \
--header 'Authorization: Bearer <token>'

Response Example

401 - Example 1

{
    "error": {
        "code": "string",
        "message": "string"
    }
}

Modified at 2026-10-26 12:58:15

Remove access (owner, or leave yourself)

Document invitations to your verified email