---
title: "List handoff snapshot attachments for a run"
method: GET
path: "/agent/runs/{runId}/handoff/attachments"
tags: ["Agents"]
---

# List handoff snapshot attachments for a run

`GET /agent/runs/{runId}/handoff/attachments`

## Request

- Base URL: `https://app.warp.dev/api/v1`
- URL: `https://app.warp.dev/api/v1/agent/runs/{runId}/handoff/attachments`
- Auth: HTTP bearer

Return fresh presigned download URLs for handoff snapshot files uploaded
by the latest ended execution of this run. An empty list is returned
when no ended execution exists or no snapshot files were uploaded.

This endpoint is useful for third-party harnesses that want to download
the snapshot files produced by a previous execution before starting a
handoff execution themselves.

## Path parameters

- `runId` string, required

## Response `200`

Handoff snapshot attachments (possibly empty)

- ListHandoffSnapshotAttachmentsResponse: Response body for listing handoff snapshot attachments.
  - `attachments` HandoffSnapshotAttachmentInfo[], required: Handoff snapshot attachments exposed by the latest ended execution. Empty when no ended execution exists or no files were uploaded.
    - `attachment_id` string, required: Identifier for the snapshot attachment within the run.
    - `filename` string, required: Original filename of the snapshot attachment.
    - `download_url` string, uri, required: Time-limited signed URL to download the snapshot attachment.
    - `mime_type` string: MIME type of the snapshot attachment, if known.

## Other responses

- `400`: Missing run ID
- `401`: Authentication required
- `403`: No permission to view the run
- `500`: Internal server error

## Changes

- **2026-10-15** `f4630aae17ba`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/runs/:runId/handoff/attachments/get.md)

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/warp/apis/oz-agent-api/revisions/4b5d145669be?raw)