Docmost Octri Preview
POST/workspace/invites/revoke

Revoke a workspace invitation

Revokes a workspace invitation so the invitee can no longer use it. Supply the invitation's UUID in invitationId; the authenticated user must have Manage/Member permission.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 body field

The workspace invitation to revoke.

invitationIdstringrequired
The UUID of the invitation to revoke.

2 status codes
200Returns a response confirming that the invitation was revoked, with the standard `data`, `status`, and `success` fields.
dataunknownoptional
Response payload
statusintegeroptional
successbooleanoptional
403Returned when the authenticated user does not have Manage/Member permission.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

invitationId must be a UUID identifying the invitation to revoke. A 403 is returned when the authenticated user lacks Manage/Member permission.