---
title: "Get authenticated workspace context"
method: GET
path: "/v1/me/workspaces"
tags: ["Discovery"]
---

# Get authenticated workspace context

`GET /v1/me/workspaces`

Returns the current workspace and authentication details. OAuth users also receive their accepted memberships and can opt into pending invitations; organization API keys only receive their current workspace. Discovery does not change the workspace bound to the bearer token.

## Query parameters

- `includePending` 'true'

## Response `200`

Workspace context fetched successfully

- GetWorkspacesResponse
  - `currentWorkspace` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required
  - `workspaces` object[], required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required
    - `role` string, nullable, required
    - `status` 'active' | 'pending', required
    - `isCurrent` boolean, required
  - `authentication` union, required
    - object
      - `type` 'apiKey', required
    - object
      - `type` 'oauth', required
      - `accountId` string, required
      - `scopes` string[], required

## Other responses

- `400` — Invalid query parameters
- `401` — Missing or invalid bearer token
- `403` — Bearer token is not scoped to an organization
- `404` — Current workspace not found
- `503` — Authentication service unavailable

## Changes

- **2026-09-16** `09c81905581f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/me/workspaces/get.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) · [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/5e3468b31d52?raw)