---
title: "Get a view"
method: GET
path: "/views/{viewId}"
tags: ["views"]
---

# Get a view

`GET /views/{viewId}`

## Path parameters

- `viewId` string, required

## Query parameters

- `remoteNode` string

## Response `200`

View

- View
  - `id` string, required
  - `name` string, required
  - `type` string, required
  - `workspace` string
  - `labels` string[]
  - `dagName` string
  - `intervalDays` integer, required
  - `columns` ViewColumn[] — Visible status columns in left-to-right display order.
  - `pinned` boolean
  - `workspaceScope` 'all' | 'default' | 'workspace' — Workflows page workspace selection represented by the view.
  - `sortField` 'name' | 'nextRun' — Field used to sort workflows.
  - `sortOrder` 'asc' | 'desc' — Direction used to sort workflows.
  - `activeOnly` boolean — Whether the view only includes scheduled, unsuspended workflows.
  - `isDefault` boolean
  - `createdBy` string — Username of the creator, for display only.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `401` — Not authenticated
- `404` — Not found
- `default` — Generic error response

## Changes

- **2026-08-06** (v1) `0d213ffd171d` — 1 info
  - added the optional property `activeOnly` to the response with the `200` status
- **2026-08-05** (v1) `b3f6451c9e92` — 4 info
  - added the optional property `isDefault` to the response with the `200` status
  - added the optional property `sortField` to the response with the `200` status
  - added the optional property `sortOrder` to the response with the `200` status
  - added the optional property `workspaceScope` to the response with the `200` status
- **2026-07-23** (v1) `75b8e91aaf57` — 9 warning
  - added the new `conflict` enum value to the `code` response property for the response status `401`
  - added the new `conflict` enum value to the `code` response property for the response status `404`
  - added the new `conflict` enum value to the `code` response property for the response status `default`
  - added the new `human_task_resume_failed` enum value to the `code` response property for the response status `401`
  - …5 more
- **2026-07-12** (v1) `fed7dff10239` — 1 info
  - added the optional property `columns` to the response with the `200` status
- **2026-06-20** (v1) `8f59259aca66` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/dagucloud/apis/dagu/changes/views/:viewId/get.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) · [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/5dc2b1ef8770/schema)