Docmost Octri Preview
POST/pages/remove-permission

Revoke user or group access to a page

Revokes user or group access to a page. Supply pageId and at least one non-empty userIds or groupIds array to identify whose permissions to remove; each array can contain at most 25 UUIDs.

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

3 body fields

Page access revocation details. Include at least one non-empty userIds or groupIds array.

groupIdsarray<string>optional
UUIDs of the groups whose access to the page you want to revoke. Supply no more than 25 IDs.
pageIdstringrequired
Page identifier.
userIdsarray<string>optional
UUIDs of the users whose access to the page you want to revoke. Supply no more than 25 IDs.

3 status codes
200Returns a successful response confirming that the permissions were revoked.
dataunknownoptional
Response payload
statusintegeroptional
successbooleanoptional
400Returned when neither `userIds` nor `groupIds` is supplied as a non-empty array.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
403Returned when the authenticated user is forbidden from revoking access or page permissions are not included in the current licence.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

A 400 is returned if userIds and groupIds are both missing or empty. A 403 is returned when the authenticated user is forbidden from revoking access or page permissions are not included in the current licence. pageId is required, and each supplied ID must be a UUID, with no more than 25 IDs per array.