---
title: "Get All Workspaces"
method: POST
path: "/v3/workspaces/list"
tags: ["workspaces"]
---

# Get All Workspaces

`POST /v3/workspaces/list`

Get all Workspaces, paginated with optional filters.

## Query parameters

- `reverse` boolean — Whether to reverse the order of results
- `page` integer — Page number
- `size` integer — Page size

## Request body

- WorkspaceGet
  - `filters` object, nullable

## Response `200`

Successful Response

- PageWorkspace
  - `items` Workspace[], required
    - `id` string, required
    - `metadata` object
    - `configuration` object
    - `created_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `pages` integer, required

## Other responses

- `422` — Validation Error

## Changes

> 10 revisions in range; 1 could not be searched.

- **2026-05-21** (v3) `fb8bc7682a0f` — 2 breaking
  - `query` request parameter `reverse` list-of-types was narrowed by removing types `null`
  - for the `query` request parameter `reverse`, the type/format was changed from ``/`` to `boolean`/``
- **2026-05-21** (v3) `ef09f89756fb` — 1 info
  - added the new optional `query` request parameter `reverse`
- **2026-02-26** (v3) `0730be052dc9` — 4 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - the response property `pages` became required for the status `200`
  - the response property `total` became required for the status `200`

[Change history](https://skmtc.dev/plastic-labs/apis/honcho-api/changes/v3/workspaces/list/post.md)

---

[API](https://skmtc.dev/plastic-labs/apis/honcho-api.md) · [All operations](https://skmtc.dev/plastic-labs/apis/honcho-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastic-labs/honcho-api/revisions/63b701d883c9/schema)