Create Workspace

POST

/workspaces

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.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.getpostman.com/workspaces' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workspace": {
        "collections": [
            {
                "id": "e1fc3c38-a0b8-44a3-bd44-d753a96b2e9d",
                "name": "Straw hats",
                "uid": "8154-e1fc3c38-a0b8-44a3-bd44-d753a96b2e9d"
            }
        ],
        "description": "Some description",
        "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"
            }
        ],
        "name": "New Workspace",
        "type": "personal"
    }
}'

Response Example

200 - Successful Response

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

Request

Body Params application/json

workspace

object

optional

collections

array [object {3}]

optional

description

string

optional

Example:

Some description

environments

array [object {3}]

optional

mocks

array [object {1}]

optional

monitors

array [object {1}]

optional

name

string

optional

Example:

New Workspace

type

string

optional

Example:

personal

Examples

Responses

🟢200Successful Response

application/json

Body

workspace

object

optional

string

optional

Example:

cfbcd9bf-cc8b-4d6f-b8ef-440a3e49e29f

name

string

optional

Example:

New Workspace

🟠400Instance supplied not found

All workspaces

Delete Workspace