Logo
15_Days_of_Postman_-_for_testers_IvanKo API Documentation

Get all workspaces

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" }, ] }



Curl
curl -X GET 'https://api.getpostman.com/workspaces?type=<string>&include=<string>&createdBy=<string>'

ENDPOINTS