---
title: "Download an artifact"
method: GET
path: "/v0/agents/{id}/artifacts/download"
---

# Download an artifact

`GET /v0/agents/{id}/artifacts/download`

## Request

- Base URL: `https://api.cursor.com`
- URL: `https://api.cursor.com/v0/agents/{id}/artifacts/download`
- Auth: HTTP bearer

Retrieve a temporary 15-minute presigned S3 URL for a specific artifact from an agent created within the last 6 months. The response includes both the URL and its expiration time.

## Path parameters

- `id` string, required

## Query parameters

- `path` string, required

## Response `200`

Artifact URL retrieved successfully

- GetArtifactResponse
  - `url` string, uri, required: Temporary 15-minute presigned S3 URL for downloading the artifact
  - `expiresAt` string, date-time, required: When the presigned download URL expires

## Other responses

- `400`: Invalid request - bad agent ID format, missing path query parameter, or artifacts expired for an agent older than 6 months
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - insufficient permissions
- `404`: Agent or artifact not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api.md) - [All operations](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/revisions/62c9131c7ea0?raw)