---
title: "List workspaces"
method: GET
path: "/v2/workspaces"
tags: ["Workspaces"]
---

# List workspaces

`GET /v2/workspaces`

Returns workspaces the caller can access. A user session lists every membership. A management key lists only the workspace bound to the key. Project keys are rejected.

## Query parameters

- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

OK

- ListWorkspacesResponse
  - `object` string, required
  - `data` Workspace[], required
    - `id` string, required
    - `key` string, required
    - `display_name` string, required
    - `logo_url` string
    - `archived_on` string, date-time
    - `archived_by_id` string
    - `organization` WorkspaceOrganization
      - `id` string
      - `key` string
    - `settings` WorkspaceSettingsFields
      - `same_project_entities_enabled` boolean
      - `model_garden_settings` object
      - `plugins` object
    - `sidebar_version` string
    - `features` object
    - `total_members` integer
    - `metadata` object
    - `capabilities` WorkspaceCapabilities
      - `roles` string[]
      - `projects` string[]
  - `has_more` boolean, required

## Changes

> 350 revisions in range; 136 not diffed.

- **2026-09-07** `bcd6172f8655` — 1 info
  - endpoint added
- **2026-09-07** `dcc0afb98a48` — 1 breaking
  - api path removed without deprecation
- **2026-09-06** `e1a2869bc12f` — 1 info
  - endpoint added
- **2026-09-06** `28c58af69b8c` — 1 breaking
  - api path removed without deprecation
- **2026-09-04** `bd22332086ec` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/workspaces/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/3c7d859558ee?raw)