---
title: "List documents"
method: GET
path: "/v1/documents"
tags: ["Knowledge"]
---

# List documents

`GET /v1/documents`

List knowledge documents for the authenticated user with cursor-based pagination.

## Query parameters

- `cursor` string
- `limit` integer, required
- `sort` 'createdAt' | 'updatedAt', required
- `order` 'asc' | 'desc', required

## Headers

- `X-Runway-Version` '2024-11-06', required

## Response `200`

Success

- object
  - `data` object[], required — The list of items for the current page.
    - `id` string, uuid, required — The unique identifier of the document.
    - `name` string, required — The name of the document.
    - `type` 'text' | 'file', required — The type of document.
    - `usedBy` object[], required — Avatars that use this document.
      - `id` string, uuid, required — The avatar ID.
      - `name` string, required — The avatar name.
      - `imageUrl` string, uri, nullable, required — URL to the avatar image, or null if not yet processed.
    - `createdAt` string, date-time, required — When the document was created.
    - `updatedAt` string, date-time, required — When the document was last updated.
  - `hasMore` boolean, required — Whether there are more items available after this page.
  - `nextCursor` string, nullable, required — Cursor to use for fetching the next page, or null if there are no more pages.

---

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