---
title: "List spaces"
method: POST
path: "/listSpaces"
tags: ["Workspace"]
---

# List spaces

`POST /listSpaces`

## Request

- Base URL: `https://www.taskade.com/api/v2`
- URL: `https://www.taskade.com/api/v2/listSpaces`
- Auth: OAuth 2 and HTTP bearer
  - Authorization code: `https://www.taskade.com/oauth2/authorize`
  - Token URL: `https://www.taskade.com/oauth2/token`

## Request body

- object, nullable
  - `filterBy` object
    - `name` union
      - object
        - `operator` 'contains', required
        - `value` string, required
      - object
        - `operator` 'equals', required
        - `value` string, required

## Response `200`

Default response

- object
  - `ok` true, required
  - `items` object[], required
    - `id` string, required
    - `name` string, required

---

[API](https://skmtc.dev/taskade/apis/taskade-public-api-v2.md) - [All operations](https://skmtc.dev/taskade/apis/taskade-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/taskade/apis/taskade-public-api-v2/revisions/45f0e74ec083?raw)