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.

Request Body

{"workspace"=>{"name"=>"{{workspaceName}}", "description"=>"{{workspaceDescription}}", "type"=>"{{workspaceType}}"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

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