getWorkspaces
List all workspaces you have access to, with options to filter by type, creator, or API element. Supports pagination and returns visibility status.
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.
Results are paginated. Use the `cursor` parameter to retrieve additional pages.
Examples:
“List my workspaces” → GET `/me`, then GET `/workspaces?createdBy={me.user.id}&limit=100`
“List my personal workspaces” → GET `/me`, then GET `/workspaces?type=personal&createdBy={me.user.id}&limit=100`
“List all public workspaces” → GET `/workspaces?type=public&limit=100`
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. | |
| elementType | No | Filter results to return the workspace where the given element type is located. If you pass this query parameter, you must also pass the `elementId` query parameter. | |
| elementId | No | Filter results to return the workspace where the given element's ID is located. When filtering by collection, you must use the collection's unique ID (`userId`-`collection`). If you pass this query parameter, you must also pass the `elementType` query parameter. | |
| cursor | No | The cursor to get the next set of results in a paginated response. Get this value from the `meta.nextCursor` field in the previous response. | |
| limit | No | The maximum number of workspaces to return per page. Defaults to 100. |