/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Revoke Invitation

Revoke Invitation

Cancel an invitation so its link stops working.

DELETE/v1/orgs/{orgId}/invites/{inviteId}Try it
Session token

Cancels an invitation. Its link stops working: accepting it returns 400.

Note

Requires the admin or owner role and a session JWT. API keys are rejected with 401. Any plan.

Revoking only changes the invitation. If it was already accepted, the person stays a member — use Remove Member for that.

Path Parameters

NameDescription
orgId:stringpathRequired
The organization ID.
inviteId:stringpathRequired
The invitation id from List Invitations.

Response — 200 OK

The change is recorded in the audit log as org.invite.revoked.

Error Responses

401 Unauthorized

unauthorized for a missing, invalid or expired token (or an API key); session_revoked when the session has been signed out.

403 Forbidden

forbidden — you are a member ("Only workspace admins can revoke invites.", with details.requiredRole: "admin" and details.currentRole), or you don't belong to the workspace ("Not a member of this organization").

404 Not Found

not_found — no invitation with that id in this workspace ("Invite not found"), or the workspace does not exist or has been deleted ("Organization not found").

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X DELETE https://api.syntext.dev/v1/orgs/3f9c2a1e-6b4d-4e8a-a1c7-5d2e9f0b7c13/invites/9b1d3f5a-7c2e-4a6b-8d0f-1e3a5c7b9d24 \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
200OK
{
"data": {
"id": "9b1d3f5a-7c2e-4a6b-8d0f-1e3a5c7b9d24",
"revoked": true
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext