---
title: "List agent artifacts"
method: GET
path: "/v0/agents/{id}/artifacts"
---

# List agent artifacts

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

## Request

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

List artifacts generated by a cloud agent created within the last 6 months. Returns at most 100 artifacts.

## Path parameters

- `id` string, required

## Response `200`

Artifacts retrieved successfully

- ListArtifactsResponse
  - `artifacts` Artifact[], required: Artifacts generated by the cloud agent. Returns at most 100 artifacts.
    - `absolutePath` string, required: Absolute artifact path in the cloud agent environment
    - `sizeBytes` integer, required: Artifact file size in bytes
    - `updatedAt` string, date-time, required: Last modified timestamp for the artifact

## Other responses

- `400`: Invalid request - bad agent ID format or artifacts expired for an agent older than 6 months
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - insufficient permissions
- `404`: Agent not found or access denied
- `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)