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

# List workspaces

`GET /v1/workspaces`

Get all workspaces accessible to the authenticated user

## Response `200`

List of workspaces

- WorkspaceList
  - `total` integer, required — Total number of workspaces
  - `workspaces` Workspace[], required
    - `awsRoleArn` string, nullable — AWS IAM role ARN for integrations
    - `createdAt` string, date-time, required — Timestamp when workspace was created
    - `googleServiceAccountEmail` string, email, nullable — Google service account email for integrations
    - `id` string, uuid, required — Unique identifier for the workspace
    - `name` string, required — Display name of the workspace
    - `slug` string, required — URL-friendly unique identifier

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/ctrlplanedev/apis/ctrlplane-api.md) · [All operations](https://skmtc.dev/ctrlplanedev/apis/ctrlplane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ctrlplanedev/ctrlplane-api/revisions/156e0d264995/schema)