---
title: "List content"
method: GET
path: "/api/v1/content"
tags: ["Content"]
---

# List content

`GET /api/v1/content`

## Query parameters

- `cursor` string — Cursor for pagination (from previous response nextCursor)
- `pageSize` integer — Number of results per page (1-100, integer)
- `creatorId` string, uuid — Filter by creator user ID
- `folderId` string, uuid — Filter by folder ID (cannot be used with path)
- `include` string — Comma-separated list of fields to include (e.g., _count,labels)
- `path` string — Filter by folder path (cannot be used with folderId)
- `scope` 'organization' | 'restricted' — Filter by share scope
- `sortDirection` 'asc' | 'desc' — Sort direction
- `sortField` 'name' | 'favorites' — Field to sort by

## Response `200`

List of content (documents and folders)

- ContentListResponse
  - `pageInfo` PageInfo, required
    - `hasNextPage` boolean, required — Whether more results are available
    - `nextCursor` string, nullable, required — Cursor for fetching the next page
    - `pageSize` number, required — Number of results per page
    - `totalRecords` number, required — Total number of records matching the query
  - `records` union[], required
    - union
      - object
        - `name` string, required — Content name
        - `owner` OwnerInternal, required — Content owner
          - `id` string, required — Owner membership ID
          - `name` string, required — Owner display name
        - `scope` 'restricted' | 'organization', required — Content access scope
        - `_count` object — Document counts
          - `favorites` number, required — Number of users who favorited
          - `views` number, required — Number of views
        - `connectionId` string, required — Connection ID
        - `deleted` boolean, required — Whether document is deleted
        - `description` string, nullable — Document description
        - `folder` InternalFolder, nullable, required — Parent folder
          - `id` string, required — Folder ID
          - `name` string, required — Folder name
          - `path` string, required — Folder path
          - `scope` 'restricted' | 'organization', required — Folder access scope
        - `hasApp` boolean, required — Whether document has an app
        - `hasDashboard` boolean, required — Whether document has a dashboard
        - `identifier` string, required — Document identifier
        - `labels` string[] — Applied labels
        - `lastViewedAt` string, date-time, nullable — Last time the dashboard was viewed
        - `updatedAt` string, date-time, nullable, required — Last updated timestamp
        - `url` string, required — URL to view the document. Returns the dashboard URL if it has a dashboard, the app URL if it has an app, otherwise the workbook URL.
        - `visits` number, nullable — Number of visits to the document's dashboard, or to its app if it has one instead. Absent until the first visit.
        - `type` 'document', required
      - object
        - `id` string, required — Unique identifier
        - `name` string, required — Content name
        - `owner` object, required — Content owner
          - `id` string, required — User ID of the owner
          - `name` string, required — Name of the owner
        - `scope` 'restricted' | 'organization', required — Content access scope
        - `_count` object — Folder counts
          - `documents` number, required — Number of documents
          - `favorites` number, required — Number of users who favorited
        - `labels` string[] — Labels
        - `path` string, required — Full path to the folder
        - `url` string, required — URL to view the folder in the Omni UI.
        - `type` 'folder', required

## Other responses

- `400` — Invalid query parameters (cannot use both folderId and path)
- `401` — Authentication required
- `404` — Folder not found (when filtering by path)

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/de7cac8b5983/schema)