NEnetxms
Objects

Replace object access control list

Changed on

Replace the object's directly assigned access control list and set the inherited-rights flag. This is a full replacement: any user or group not present in accessList loses its directly assigned rights on the object. Both members are optional; an omitted member leaves the current value unchanged. Requires both modify and access-control rights on the object.

put/v1/objects/{object-id}/access-rights

Request

  • Base URL
    http://127.0.0.1:8000
  • URL
    http://127.0.0.1:8000/v1/objects/{object-id}/access-rights
  • Auth
    HTTP bearer

Path parameters

object-idinteger required

Request body

inheritAccessRightsboolean

When true, rights are inherited from parent objects for users that no entry in the list below matches, either directly or through one of their groups, and are combined across all parents. Inherited rights do not add to directly assigned rights - a matching entry below replaces them entirely, even when it grants nothing. See EffectiveRights for the full resolution order.

Response

Access rights updated; the resulting access control list is returned.

inheritAccessRightsboolean

When true, rights are inherited from parent objects for users that no entry in the list below matches, either directly or through one of their groups, and are combined across all parents. Inherited rights do not add to directly assigned rights - a matching entry below replaces them entirely, even when it grants nothing. See EffectiveRights for the full resolution order.

Changes