Logo
30-day challenge API Documentation

Create a workspace

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

Creates a new [workspace] Include the following properties in the request body:

  • name — A string that contains the workspace's name.
  • type — A string that contains the workspace type:
    • personal — A personal workspace.
    • team — A team workspace.

You can include the following optional properties in the request body:

  • description — A string that contains a description of the workspace.

Important:

We deprecated linking collections or environments between workspaces. We do not recommend that you do this.

If you have a linked collection or environment, note the following:

  • The endpoint does not create a clone of a collection or environment.
  • Any changes you make to a linked collection or environment changes them in all workspaces.
  • If you delete a collection or environment linked between workspaces, the system deletes it in all the workspaces.

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 
Content-Type
string




RESPONSES

status OK

{ "workspace": { "id": "1f0df51a-8658-4ee8-a2a1-d2567dfa09a9", "name": "Test Workspace" } }



Curl
curl -X POST 'https://api.getpostman.com/workspaces' -H 'Content-Type: application/json' -d '{"workspace":{"name":"undefined","description":"undefined","type":"undefined"}}'

ENDPOINTS