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

# List workspaces

`GET /workspaces`

## Query parameters

- `page_no` integer
- `page_size` integer
- `limit` integer
- `sort` 'id.desc' | 'id.asc'
- `after` string
- `before` string
- `name` string
- `created_at` union
  - object
    - `gt` integer
    - `gte` integer
    - `lt` integer
    - `lte` integer
  - integer
- `metadata` object

## Response `200`

OK

- union
  - object
    - `total` integer — Total number of resources.
    - `data` object[] — List of resources
      - `id` string
      - `name` string, nullable
      - `description` string, nullable
      - `metadata` Metadata
      - `created_at` integer
      - `updated_at` integer
  - object
    - `next` string, nullable — URI to next page when available.
    - `prev` string, nullable — URI to previous page when available.
    - `data` object[] — List of resources
      - `id` string
      - `name` string, nullable
      - `description` string, nullable
      - `metadata` Metadata
      - `created_at` integer
      - `updated_at` integer

## Changes

> 44 revisions in range; 18 could not be searched.

- **2025-07-29** `232f34fd9749` — 2 breaking, 3 info
  - the response property `allOf[subschema #2]/data/items/description` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/name` became nullable for the status `200`
  - the response optional property `allOf[subschema #2]/data/items/created_at` became read-only for the status `200`
  - the response optional property `allOf[subschema #2]/data/items/updated_at` became read-only for the status `200`
  - …1 more
- **2024-09-06** `041875436163` — 2 info
  - added the new optional `query` request parameter `page_no`
  - added the new optional `query` request parameter `page_size`
- **2024-08-19** `df1285c8e7dd` — 1 info
  - endpoint added
- **2024-08-06** `f104b2885b04` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api/changes/workspaces/get.md)

---

[API](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api.md) · [All operations](https://skmtc.dev/webhookx-io/apis/webhookx-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webhookx-io/webhookx-admin-api/revisions/0afb563ce365/schema)