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

# List workspaces

`GET /api/v3/workspaces`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/workspaces`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/docs/api/v3/workspaces/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of workspaces

## Response `200`

Get a list of Workspaces

- PaginatedWorkspaceList
  - `count` integer: Number of workspaces
  - `next` string: URL to the next page
  - `previous` string: URL to the previous page
  - `results` Workspace[]
    - `id` integer: Workspace ID
    - `title` string: Workspace title

## Other responses

- `401`: Forbidden

---

[API](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3.md) - [All operations](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/revisions/a881099bd6c4?raw)