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

# List Workspaces

`GET /v2/workspaces`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/workspaces`
- Auth: HTTP bearer

List workspaces with optional filtering.

**Filters:**
- role: "owner" (created by), "member" (invited to), or omit for all
- folder_id: Filter by folder
- include_progress: Include progress calculation (default: true)

**Legacy filters:**
- owner_id: Filter by owner (deprecated, use role=owner instead)

Returns lightweight card data for efficient list rendering.
Stats (total_contents, etc.) are calculated dynamically from the database.

**Examples:**
- No params → All workspaces the authenticated user has access to
- `?role=owner` → Workspaces created by the authenticated user
- `?role=member` → Workspaces the authenticated user was invited to
- `?include_progress=false` → Skip progress calculation for performance

## Query parameters

- `role` string, nullable
- `owner_id` string, nullable
- `folder_id` string, nullable
- `include_progress` boolean
- `archived` boolean
- `include_archived` boolean
- `limit` integer
- `offset` integer

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)