---
title: "List Attachments"
method: GET
path: "/api/v1/beta/attachments"
tags: ["Beta", "File Attachments", "Attachments"]
---

# List Attachments

`GET /api/v1/beta/attachments`

## Request

- Base URL: `https://api.cloud.llamaindex.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cloud.llamaindex.ai/api/v1/beta/attachments`
- Auth: HTTP bearer

List the attachments associated with a file (e.g. per-page screenshots).

## Query parameters

- `source_id` string, required: File UUID or directory file ID (dfl-...).
- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable
- `page_size` integer, nullable
- `page_token` string, nullable

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- FileAttachmentListResponse: Paginated list of file attachments.
  - `items` FileAttachmentMetadata[], required: The list of items.
    - `name` string, required: Name of the attachment
    - `size` integer, required: Size of the attachment in bytes
    - `last_modified` string, date-time, nullable: When the attachment was last modified
  - `next_page_token` string, nullable: A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `total_size` integer, nullable: The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `a38b684f8e1b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/run-llama/apis/llama-platform/changes/api/v1/beta/attachments/get.md)

---

[API](https://skmtc.dev/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.dev/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/run-llama/apis/llama-platform/revisions/809d302cdb1e?raw)