Logo
30 days of Postman - for developers API Documentation

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.

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 
Content-Type
string




RESPONSES

status OK

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



Curl
curl -X PUT 'https://api.getpostman.com/workspaces/undefined' -H 'Content-Type: application/json' -d '{"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"}]}}'

ENDPOINTS