---
title: "List the caller's accessible workspaces"
method: GET
path: "/v1/workspaces/me"
tags: ["Workspaces"]
---

# List the caller's accessible workspaces

`GET /v1/workspaces/me`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/v1/workspaces/me`
- Auth: none declared

Return the current user's accessible non-archived workspaces, each annotated with the two per-workspace management permission booleans (manage OAuth clients / manage resource filters) used by the Scope Selector and Filter Management page. Served by the main Pirros API host and requires a logged-in user session (not a client-credentials Bearer token). Unpaginated in v1 (next_cursor is always null).

## Response `200`

Accessible workspaces

- ListWorkspacesMeResponse: The caller's accessible non-archived workspaces. Unpaginated in v1 (next_cursor is always null).
  - `response` object, required
    - `data` WorkspaceMeItem[], required
      - `workspace_id` string, uuid, required
      - `workspace_name` string, required
      - `user_has_manage_oauth_clients` boolean, required
      - `user_has_manage_resource_filters` boolean, required
      - `user_has_create_firm_stashes` boolean
      - `archived` boolean, required
    - `next_cursor` unknown, required
  - `meta` object, required
    - `request_id` string, uuid, required

## Other responses

- `401`: Unauthorized (no logged-in user session). Flat main-API-host error shape, not the /v1 envelope.

---

[API](https://skmtc.dev/pirros/apis/pirros-external-api.md) - [All operations](https://skmtc.dev/pirros/apis/pirros-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pirros/apis/pirros-external-api/revisions/01c66b8d9fd1?raw)