getWorkspaces
Retrieve and filter Postman workspaces by type or creator to manage API development access and organization.
Instructions
Gets all workspaces you have access to.
For “my …” requests, first call GET `/me` and pass `createdBy={me.user.id}`.
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).
`public` — Everyone can access the workspace.
`partner` — Invited team members and partners (Professional and Enterprise).
For tools that require the workspace ID, and no workspace ID is provided, ask the user to provide the workspace ID. If the user does not provide the workspace ID, call this first with the createdBy parameter to use the first workspace.
Examples:
“List my workspaces” → GET `/me`, then GET `/workspaces?createdBy={me.user.id}`
“List my personal workspaces” → GET `/me`, then GET `/workspaces?type=personal&createdBy={me.user.id}`
“List all public workspaces” → GET `/workspaces?type=public`
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | The type of workspace to filter the response by. One of: `personal`, `team`, `private`, `public`, `partner`. - For “my …” requests, this can be combined with `createdBy`. If type is not specified, it will search across all types for that user. | |
| createdBy | No | Return only workspaces created by the specified Postman user ID. - For “my …” requests, set `createdBy` to the current user’s ID from GET `/me` (`me.user.id`). - If the user's ID is not known, first call GET `/me`, then retry with `createdBy`. | |
| include | No | 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. |