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

# GET /workspace/{workspaceId}/views/{viewId}

`GET /workspace/{workspaceId}/views/{viewId}`

A single view's full configuration, by its id.

## Path parameters

- `workspaceId` string, required
- `viewId` string, required

## Query parameters

- `includeRaw` boolean
- `includeCompleted` boolean

## Response `200`

The view configuration

- ViewDetail
  - `viewId` string, required
  - `name` string, required
  - `viewType` string, required
  - `ownerType` 'personal' | 'workspace', required
  - `category` string
  - `workspaceId` string
  - `portfolioId` string
  - `webUrl` string
  - `controllers` ViewControllers, required
    - `sortBy` string
    - `sortDirection` 'asc' | 'desc'
    - `groupBy` string
    - `swimLanesBy` string
  - `columns` string[]
  - `layout` string[]
  - `compactMode` string — Card density on a card-based view: `compact` or `default`.
  - `filters` RecordStringUnknown, required — Construct a type with a set of properties K of type T
  - `listItemsParams` RecordStringString, required — Construct a type with a set of properties K of type T
  - `listItemsTool` 'list_items' | 'list_portfolio_items' | 'list_feedback_items', required — Which list tool `listItemsParams` belongs to. Feedback views are the reason this is stated rather than assumed — their items are not work items.
  - `unsupportedFilters` UnsupportedFilter[] — Filters the list endpoints cannot reproduce — the result will be wider.
    - `filter` string, required
    - `reason` string, required
  - `raw` WireView — A view exactly as the views service stores it. Unknown props round-trip.
    - `id` string
    - `name` string
    - `categoryId` string
    - `workspaceId` string
    - `personId` string, nullable
    - `ownerType` string
    - `viewType` string
    - `orderIndex` string
    - `category` string, nullable
    - `nameId` string, nullable
    - `description` string, nullable
    - `viewFields` string[], nullable
    - `compactViewFields` string[], nullable
    - `compactMode` string, nullable — Card density on a card-based view; empty string means never set.
    - `groupBy` string, nullable
    - `groupByCustomFieldId` string, nullable
    - `secondaryGroupBy` string, nullable
    - `secondaryGroupByCustomFieldId` string, nullable
    - `sortBy` string, nullable
    - `sortByCustomFieldId` string, nullable
    - `reverse` boolean, nullable
    - `isChanged` boolean
    - `okrHierarchy` string, nullable
    - `fieldFilters` RecordStringUnknown — Construct a type with a set of properties K of type T
    - `filters` RecordStringUnknown — Construct a type with a set of properties K of type T

## Other responses

- `403` — Access denied
- `404` — No view found

---

[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)