---
title: "List workspaces"
method: GET
path: "/v2/workspaces"
tags: ["Workspaces"]
---

# List workspaces

`GET /v2/workspaces`

## Request

- Base URL: `https://api.infolang.ai`
- URL: `https://api.infolang.ai/v2/workspaces`
- Auth: HTTP bearer

## Response `200`

Workspaces the caller holds a grant on (always wrapped, never a bare array)

- object
  - `workspaces` object[], required
    - `workspace_id` string, required
    - `name` string, required
    - `plan` string, required
    - `created` string, required
    - `role` 'Owner' | 'Admin' | 'Member' | 'ReadOnly', required

## Other responses

- `401`: Missing or invalid session token
- `403`: Caller lacks a grant on the workspace, or role too low. Or `lane_not_supported` — an `il_live_`/`il_test_`/`il_oauth_` credential, though valid, was presented to a route that accepts the session lane only

---

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