get single workspace
GET https://api.getpostman.com/workspaces/{{workspaceId}}
Gets information about a workspace.
Note:
This endpoint's response also 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]
Important
We have deprecated the name
and uid
responses in the following array of objects:
collections
environments
mocks
monitors
apis
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
include | string | Include the following information in the endpoint's response: |
mocks:deactivated
— Include all deactivated mock servers in the response.scim
— Return the SCIM user IDs of the workspace creator and who last modified it. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
x-api-key | string |
RESPONSES
status: OK
{"workspace":{"id":"1f0df51a-8658-4ee8-a2a1-d2567dfa09a9","name":"Partner Workspace","type":"team","description":"This is a partner workspace.","visibility":"partner","createdBy":"12345678","updatedBy":"12345678","createdAt":"2022-07-06T16:18:32.000Z","updatedAt":"2022-07-06T20:55:13.000Z","collections":[{"id":"12ece9e1-2abf-4edc-8e34-de66e74114d2","name":"Test Collection","uid":"12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2"}],"environments":[{"id":"5daabc50-8451-43f6-922d-96b403b4f28e","name":"Test Environment","uid":"12345678-5daabc50-8451-43f6-922d-96b403b4f28e"}],"mocks":[{"id":"e3d951bf-873f-49ac-a658-b2dcb91d3289","name":"Test Mock","uid":"12345678-e3d951bf-873f-49ac-a658-b2dcb91d3289","deactivated":false}],"monitors":[{"id":"1e6b6cc1-c760-48e0-968f-4bfaeeae9af1","name":"Test Monitor","uid":"12345678-1e6b6cc1-c760-48e0-968f-4bfaeeae9af1"}],"apis":[{"id":"387c2863-6ee3-4a56-8210-225f774edade","name":"Test API","uid":"12345678-387c2863-6ee3-4a56-8210-225f774edade"}]}}