---
title: "Scroll Files with Groups"
method: GET
path: "/api/dataset/scroll_files"
tags: ["File"]
---

# Scroll Files with Groups

`GET /api/dataset/scroll_files`

Scroll through the files along with their groups in a dataset. This is useful for paginating through files. The cursor is used to fetch the next page of files. The page size is used to specify how many files to fetch per page. The default page size is 10.

## Query parameters

- `cursor` string, uuid, nullable
- `page_size` integer, nullable

## Headers

- `TR-Dataset` string, uuid, required

## Response `200`

JSON body representing the files along with their associated groups in the current dataset

- GetFilesCursorResponseBody
  - `file_with_chunk_groups` FileWithChunkGroups[], required — This is a paginated list of files and their associated groups. The page size is specified in the request. The cursor is used to fetch the next page of files.
    - `chunk_groups` ChunkGroup[], nullable
      - `created_at` string, date-time, required
      - `dataset_id` string, uuid, required
      - `description` string, required
      - `id` string, uuid, required
      - `metadata` unknown
      - `name` string, required
      - `tag_set` string[], nullable
      - `tracking_id` string, nullable
      - `updated_at` string, date-time, required
    - `created_at` string, date-time, required
    - `dataset_id` string, uuid, required
    - `file_name` string, required
    - `id` string, uuid, required
    - `link` string, nullable
    - `metadata` unknown
    - `size` integer, required
    - `tag_set` string[], nullable
    - `time_stamp` string, date-time, nullable
    - `updated_at` string, date-time, required
  - `next_cursor` string, uuid, nullable — Parameter for the next cursor offset. This is used to fetch the next page of files. If there are no more files, this will be None.

## Other responses

- `400` — Service error relating to getting the files in the current datase

---

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