---
title: List your workspaces
description: >-
  Workspaces the caller belongs to (Better Auth organization plugin — user
  tenancy, distinct from the registry orgs).
---
# List your workspaces

`GET https://api.releases.sh/v1/me/workspaces`

Workspaces the caller belongs to (Better Auth organization plugin — user tenancy, distinct from the registry orgs). `active` marks the caller's current workspace. Requires a Better Auth session or a user Bearer token (`relu_` or OAuth JWT); machine `relk_` tokens and anonymous callers are refused. Read-only — creating, renaming, and switching workspaces stay on Better Auth.

**Auth:** Bearer token required.

**Responses**

- `200` The caller's workspaces, ordered by name. Empty when the caller has none.
- `401` Sign-in required

Full request and response schemas: [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json).