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

# /workspaces

`GET /v1/workspaces`

List the workspaces the authenticated user can view.

This is a discovery endpoint, with two consequences for how it is called:

- Authentication must be an OAuth 2.0 bearer token. API key authentication
  is not accepted, because API-key requests require a workspace ID and
  this is a pre-workspace discovery route.
- The `x-air-workspace-id` header is not required, since the purpose of the
  call is to discover which workspaces are available before any
  workspace-scoped call is made.

Results are filtered to workspaces the authenticated principal has
permission to view.

Requires the `workspace.read` OAuth scope.

## Response `200`

List of workspaces the authenticated user can access

- object
  - `data` object[]
    - `id` string — The unique identifier of the workspace
    - `name` string — The name of the workspace

---

[API](https://skmtc.net/air/apis/air-api.md) · [All operations](https://skmtc.net/air/apis/air-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/air/air-api/revisions/2bd9c9fa2a0c/schema)