---
title: "List workspaces"
method: GET
path: "/api/workspace"
tags: ["Workspace"]
---

# List workspaces

`GET /api/workspace`

## Request

- Base URL: `https://use.jitsu.com`
- URL: `https://use.jitsu.com/api/workspace`
- Auth: HTTP bearer

Returns workspaces the authenticated user has access to. If `page` is provided, the response is wrapped in `{ workspaces, pagination }`; otherwise an array is returned (back-compat). Use the `id` of a workspace as the `workspaceId` path parameter on other endpoints.

## Query parameters

- `page` integer: Zero-based page index
- `limit` integer: Items per page
- `search` string

## Response `200`

OK

- union
  - object
    - `workspaces` WorkspaceListItem[], required
      - `id` string, required
      - `createdAt` string, nullable, required
      - `updatedAt` string, nullable, required
      - `name` string, required
      - `slug` string, nullable
      - `featuresEnabled` string[], required
      - `lastUsed` string, date-time: Last time the current user accessed this workspace
      - `entities` number: Number of configuration objects in the workspace (admin-only)
    - `pagination` object, required
      - `page` number, required
      - `limit` number, required
      - `totalCount` number, required
      - `hasMore` boolean, required
  - WorkspaceListItem[]
    - `id` string, required
    - `createdAt` string, nullable, required
    - `updatedAt` string, nullable, required
    - `name` string, required
    - `slug` string, nullable
    - `featuresEnabled` string[], required
    - `lastUsed` string, date-time: Last time the current user accessed this workspace
    - `entities` number: Number of configuration objects in the workspace (admin-only)

## Other responses

- `400`: Bad request
- `401`: Authorization required
- `403`: Forbidden — no access to this workspace, or the workspace's plan does not include this feature
- `500`: Internal server error

---

[API](https://skmtc.dev/jitsu/apis/jitsu-api.md) - [All operations](https://skmtc.dev/jitsu/apis/jitsu-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jitsu/apis/jitsu-api/revisions/f6b8702d246f?raw)