Occupy a Workstation

Sets the current workspace of the impersonated user. The workspace must be in the user's current unit.

This endpoint requires the Agent Impersonator role.

URL

POST: https://[base-url]/{applicationId}/agents/{userId}/workstations /{workstationId}/actions/occupy

Headers

Authorization: Bearer <accessToken>

Request Body

• vacateOthers (boolean): When set to true, vacates all other workstations occupied by the user.

Response

Success -> 200

Invalid access token -> 401

The workstation is not in the user's current unit -> 404

The specified workstation is inactive --> 409, 1002

The workstation is occupied by someone else --> 409, 1003