Locks an object. Remember that the child objects under this object will be automatically locked. User can modify (set or remove) only locks which has been set by him or on objects which has not set any lock.
If at least one object is already locked by another user than the user is forbidden to do lock, the return code is 403 Forbidden, Object already locked, without any other info.
To get more information about already locked objects can be used GET method, see Check if an object is locked
When lock operation request has succeeded api call returns standard return code 200 OK. When a PUT or POST operation on any particular object is performed (eg: PUT objects/<object_id>) then presense of the the lock is checked only on this particular object & the lock is not checked on its parent or children . If user is forbidden to do the lock ( because of other lock or locks ), the returtn code is 403 Forbidden.objects. Selection lock At selection object lock (eg: PUT objects/{selectionId}/locks) the elements belonging to the selection will be locked. Selection lock doesn't support children locks, api call api with children lock parameter (default is withChildren=true) return returns code 400 Bad Request. If at least one element object (by selection) is locked by another user and the API call doesn't specify query parameter ? asAdmin=true (default is asAdmin=false), than the user is forbidden to do selection lock, the return code is 403 Forbidden. If selection contains at least one non-existent element object the return code is 403 Forbidden. |