Logo
30 Days of Postman exercises API Documentation

Create Workspace

POST https://api.getpostman.com/workspaces

This endpoint allows you to create a workspace and populate it with entities like collections, environments, mocks and monitors using their uid.

On successful creation 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.

 

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 POST 'https://api.getpostman.com/workspaces' -H 'Content-Type: application/json' -d '{"workspace":{"name":"New Workspace","type":"personal","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