GET {{baseUrl}}/workspaces
Gets all [workspaces] The response includes your workspaces and any workspaces that you have access to. Note: This endpoint's response contains the visibility
field. [Visibility] determines who can access the workspace:
personal
— Only you can access the workspace.team
— All team members can access the workspace.private
— Only invited team members can access the workspace ([Professional and Enterprise plans only]public
— Everyone can access the workspace.partner
— Only invited team members and [partners] can access the workspace ([Professional and Enterprise plans only]
Body
PARAM
Key | Datatype | Required | Description |
type
|
string | The type of workspace to filter the response by: * `personal` * `team` * `private` * `public` * `partner` | |
include
|
string | Include the following information in the endpoint's response: - `mocks:deactivated` — Include all deactivated mock servers in the response. | |
createdBy
|
string | Return only workspaces created by a specific user ID. For multiple users, pass this value as a comma-separated list of user IDs. The response only returns workspaces that you have access to. |
HEADERS
Key | Datatype | Required | Description |
RESPONSES
status OK
{
"workspaces": [
{
"id": "a0f46158-1529-11ee-be56-0242ac120002",
"name": "Test Workspace",
"createdBy": "12345678",
"type": "team",
"visibility": "private"
},
{
"id": "f8801e9e-03a4-4c7b-b31e-5db5cd771696",
"name": "Teamwork",
"createdBy": "12345678",
"type": "team",
"visibility": "team"
},
{
"id": "74dbfab8-1529-11ee-be56-0242ac120002",
"name": "Public Examples",
"createdBy": "87654321",
"type": "team",
"visibility": "public"
},
{
"id": "74dbfab8-1529-11ee-be56-0242ac120002",
"name": "Partner Workspace",
"createdBy": "87654321",
"type": "team",
"visibility": "partner"
},
{
"id": "1f0df51a-8658-4ee8-a2a1-d2567dfa09a9",
"name": "My Workspace",
"createdBy": "56784321",
"type": "personal",
"visibility": "personal"
},
]
} |
ENDPOINTS