Workspace

List Workspaces

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.

get/v1/external/workspaces

Request

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

Response

List of accessible workspaces

Example response

{
  "workspaces": [
    {
      "guid": "ws_abc123",
      "name": "Acme Corp",
      "isWikiEnabled": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.