---
title: "List workspaces the authenticated user owns or belongs to"
method: GET
path: "/v2/workspaces"
tags: ["Workspaces"]
---

# List workspaces the authenticated user owns or belongs to

`GET /v2/workspaces`

Returns every workspace where the authenticated user is either the owner or a member, hydrated with members and shared applications.

## Response `200`

Workspace list. Empty array when the user has no workspaces.

- object
  - `status` 'success', required
  - `response` Workspace[], required
    - `id` string, required — Workspace identifier. UUID v4 with hyphens stripped (32 hex chars).
    - `name` string, required — Workspace name (1-32 chars).
    - `owner` string, required — User identifier of the workspace owner.
    - `members` WorkspaceMember[], required
      - `id` string, required — User identifier of the member.
      - `name` string, required — Display name of the member.
      - `group` 'owner' | 'admin' | 'maintain' | 'manager' | 'view', required — Permission tier. `owner` and `admin` have full management; `maintain` adds operational access (commit, app actions, files, DNS, cache); `manager` covers monitoring and lifecycle control; `view` is read-only.
      - `joinedAt` string, date-time, required — Server-set timestamp of when the member joined the workspace. Not accepted as input. For the owner, equals the workspace creation time.
    - `applications` WorkspaceApp[], required
      - `id` string, required
      - `name` string, required
      - `desc` string, nullable, required — Free-form description. Present but `null` when unset.
      - `ram` integer, required — Allocated memory in MB.
      - `lang` string, required — Runtime language. Truncated form of `App.language`.
      - `domain` string, nullable, required
      - `custom` string, nullable, required
    - `createdAt` string, date-time, required

## Other responses

- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `429` — The authenticated user or API key exceeded the global request budget.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)