---
title: "GET /workspace/{workspaceId}/views"
method: GET
path: "/workspace/{workspaceId}/views"
tags: ["Views"]
---

# GET /workspace/{workspaceId}/views

`GET /workspace/{workspaceId}/views`

List the workspace's views and the categories they are organised by.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `category` string
- `ownerType` 'personal' | 'workspace'
- `name` string
- `page` number, double
- `limit` number, double

## Response `200`

The workspace views

- ViewListResponse — Saved views — the filters, grouping, sorting and columns a user has set up in the app. Reading one lets a client work on exactly what the user sees; creating one hands a result back to the user as something they can open. Views belong to a workspace or a portfolio, and are either personal (only the owner sees them) or workspace-wide (everyone, admins only to create). The routes mirror that: the same five operations under both containers.
  - `views` ViewSummary[], required
    - `viewId` string, required
    - `name` string, required
    - `viewType` string, required
    - `ownerType` 'personal' | 'workspace', required
    - `category` string
    - `workspaceId` string
    - `portfolioId` string
    - `webUrl` string
  - `categories` CategorySummary[], required — Categories the container's views menu is organised by.
    - `name` string, required
    - `scope` 'workspace' | 'personal', required
  - `canCreateWorkspaceViews` boolean, required — False when the caller may only create personal views here.
  - `page` number, double, required
  - `limit` number, double, required
  - `total` number, double, required

## Other responses

- `400` — Invalid workspace ID
- `403` — Access denied

---

[API](https://skmtc.net/craft/apis/craft-io-public-api.md) · [All operations](https://skmtc.net/craft/apis/craft-io-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craft/craft-io-public-api/revisions/df0d980eb1e3/schema)