Open topic with navigation

# 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 username credential. This situation is possible only when user authentication is disabled.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO FTL® - Enterprise Edition

Copyright © 2009-2024. Cloud Software Group, Inc. All Rights Reserved.