POST realm/workspace

The web method POST realm/workspace requests the modification lock, and opens the workspace.

If the modification lock is available, you can use this method without the force parameter.

If you request the realm modification lock while another user holds it, this request returns a 403 error response. Nonetheless, you can force this operation, grabbing the lock: 
POST realm/workspace?force=true
Forcing this operation deletes the other user's workspace. Your new workspace is a fresh copy of the most recent deployment.

HTTP Parameters

Syntax Description
force=boolean Optional.

When true, grab the modification lock, and create a new workspace.

Example Requests

curl -X PUT http://host:port/api/v1/realm/workspace

Example Response

{
  "user":"anyone"
}

The special value, anyone, indicates that the user did not supply a user name credential. This situation is possible only when user authentication is disabled.