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

# GET /workspaces

`GET /workspaces`

## Request

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

Get all workspaces for a user

## Response `200`

Workspaces

- object: Workspaces
  - `ok` true, required
  - `items` object[], required
    - `id` string, required: Unique identifier of the workspace or folder. An alphanumeric string that is either 16 characters long or 9 characters long (the 9-character version may include underscores or hyphens)
    - `name` string, required: Name of the workspace or folder.

## Other responses

- `4XX`: Error description

---

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