Update Workspace

PUT https://api.getpostman.com/workspaces/{{workspace_id}}

This endpoint allows you to update a workspace and update it's association to entities like collections, environments, mocks and monitors using their uid.

On successful updation of the workspace, the response returns the workspcae name and id.

Requires API Key as X-Api-Key request header or apikey URL query parameter.

Note : The endpoint expects you to send the desired state of the workspace in terms of the associated entities so be careful when trying to update these entities.

For eg. if your workspace has collections A and B, and in the update call, you send C's uid in the collections array, then A and B would be removed from the workspace and C would be added.

Request Body

{"workspace"=>{"name"=>"New Workspace updated", "description"=>"Some description", "collections"=>[{"id"=>"e1fc3c38-a0b8-44a3-bd44-d753a96b2e9d", "name"=>"Straw hats", "uid"=>"8154-e1fc3c38-a0b8-44a3-bd44-d753a96b2e9d"}], "environments"=>[{"id"=>"83a1aaa2-a204-4bd8-9b92-4d486918906b", "name"=>"env", "uid"=>"8154-83a1aaa2-a204-4bd8-9b92-4d486918906b"}], "mocks"=>[{"id"=>"cda672ef-1375-40e9-baee-e20ece8d7b65"}], "monitors"=>[{"id"=>"1e889bd2-3862-4be0-b2c2-9b1fe9673aec"}]}}

HEADERS

RESPONSES

status: OK

{"workspace":{"id":"cfbcd9bf-cc8b-4d6f-b8ef-440a3e49e29f","name":"New Workspace"}}