---
title: "List"
method: GET
path: "/api/v1/threads/{threadId}/attachments"
tags: ["attachments"]
---

# List

`GET /api/v1/threads/{threadId}/attachments`

## Request

- Base URL: `https://api.capy.ai`
- URL: `https://api.capy.ai/api/v1/threads/{threadId}/attachments`
- Auth: HTTP bearer

## Path parameters

- `threadId` string, required

## Query parameters

- `after` string: Exclusive forward event-ID cursor from cursor. Without either bound, returns the oldest page.
- `before` string: Exclusive backward event-ID cursor from beforeCursor. Without after, returns the nearest older page.
- `limit` string: Event-count target, default 50 and maximum 200, paged exactly like the messages list. A page can contain no attachments; continue until its directional cursor is null.

## Response `200`

ThreadAttachmentPage

- ThreadAttachmentPageEncoded
  - `items` ThreadAttachmentEncoded[], required
    - `id` string, required: The file's id, the same `file.fileId` a message's `attachments` carry. Pass it to the download endpoint.
    - `name` string, required
    - `mediaType` string, required
    - `sizeBytes` union, required
      - number
      - 'Infinity' | '-Infinity' | 'NaN'
    - `title` string: The caption the agent gave the file when it delivered it.
    - `messageId` string, required: The `id` of the transcript message that carries the file. One file the agent delivered in two messages is listed once per message.
    - `source` 'user' | 'assistant', required: `user` for a file a person or integration attached to a message, `assistant` for a file the agent delivered.
    - `createdAt` string, required
  - `cursor` string, nullable, required: Opaque exclusive event-ID cursor for after, the same cursor the messages list returns. Null when no newer events remain.
  - `beforeCursor` string, nullable, required: Opaque exclusive event-ID cursor for before. Null when no older events remain.

## Other responses

- `401`: capy/Unauthorized
- `403`: capy/Forbidden
- `404`: capy/ThreadNotFound
- `429`: capy/RateLimited

## Changes

- **2026-10-27** `32442d39d1ac`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/threads/:threadId/attachments/get.md)

---

[API](https://skmtc.dev/capy/apis/capy-api.md) - [All operations](https://skmtc.dev/capy/apis/capy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/capy/apis/capy-api/revisions/4663f7dc4e39?raw)