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

# GET /public/v1/workspaces

`GET /public/v1/workspaces`

List all workspaces the API key can access. Keys are user-scoped: a workspace appears if the key's user is a member of it, or if it has been explicitly granted to them via /public/v1/workspace-grants. Granted-only workspaces report access: "grant".

## Query parameters

- `limit` number
- `offset` number

## Response `200`

Default Response

- object
  - `statusCode` number
  - `status` boolean
  - `message` string
  - `data` object
    - `workspaces` object[]
      - `id` string
      - `name` string
      - `role` string
      - `access` 'member' | 'grant'
      - `created_at` string
    - `pagination` object
      - `limit` number
      - `offset` number
      - `total` number
      - `hasMore` boolean

## Other responses

- `401` — Default Response
- `429` — Default Response
- `500` — Default Response

## Changes

- **2026-08-28** `a8e70cca9931` — 1 info
  - added the optional property `data/workspaces/items/access` to the response with the `200` status

[Change history](https://skmtc.dev/joinvalley/apis/valley-public-api/changes/public/v1/workspaces/get.md)

---

[API](https://skmtc.dev/joinvalley/apis/valley-public-api.md) · [All operations](https://skmtc.dev/joinvalley/apis/valley-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinvalley/valley-public-api/revisions/a8e70cca9931/schema)