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

# List Workspaces

`GET /v1/external/workspaces`

## Request

- Base URL: `https://api.tiro.ooo`
- URL: `https://api.tiro.ooo/v1/external/workspaces`
- Auth: HTTP bearer

List all workspaces accessible to the caller's API key or OAuth token.

Resolution order:
1. Workspace-bound API key → the single bound workspace
2. Organization-bound API key → all active workspaces in the organization
3. Legacy team API key → the team's workspace
4. Personal/OAuth key → all workspaces the user is a member of

Pass a returned `guid` as the `{workspaceGuid}` path segment of the workspace-scoped
endpoints — notes, folders, note document templates, word memories, and wiki.

## Response `200`

List of accessible workspaces

- ExternalWorkspaceListResponse
  - `workspaces` ExternalWorkspaceSummary[], required: List of accessible workspaces
    - `guid` string, required: Unique workspace identifier
    - `name` string, required: Human-readable workspace name
    - `isWikiEnabled` boolean, required: Whether wiki is both plan-eligible and activated for this workspace

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/tiro/apis/tiro-api-2.md) · [All operations](https://skmtc.dev/tiro/apis/tiro-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tiro/apis/tiro-api-2/revisions/dc1a260c6771?raw)