--- title: "List workspaces" method: GET path: "/api/v3/meta/workspaces" tags: ["Workspaces"] --- # List workspaces `GET /api/v3/meta/workspaces` ## Request - Base URL: `https://app.nocodb.com` - URL: `https://app.nocodb.com/api/v3/meta/workspaces` - Auth: one of: - API key in header `xc-token` - HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve a list of all workspaces accessible to the user. **Note**: Listing and creating workspaces is available on all cloud-hosted plans and on all self-hosted deployments. Reading, updating, and deleting a specific workspace requires cloud-hosted **Business** plans and above, or a licensed self-hosted deployment (**Business** plan and above). Unlicensed self-hosted deployments are limited to the default workspace. ## Response `200` Workspaces retrieved successfully. - WorkspaceV3ListResponse: Workspace list response - `list` WorkspaceV3[], required: List of workspaces - `id` string, required: Unique identifier for the workspace - `title` string, required: Title of the workspace - `org_id` string: Organization identifier (required for cloud, absent for on-prem EE) - `created_at` string, date-time, required: Timestamp when the workspace was created - `updated_at` string, date-time, required: Timestamp when the workspace was last updated ## Other responses - `500`: The server encountered an unexpected error while processing the request. ## Changes - **2026-10-13** `2ba4267a99d7`: 2 info - api operation id `workspace-list` removed and replaced with `workspaces-list` - removed the non-success response with the status `400` [Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/workspaces/get.md) --- [API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)