---
title: "Get artifact details"
method: GET
path: "/agent/artifacts/{artifactUid}"
tags: ["agent"]
---

# Get artifact details

`GET /agent/artifacts/{artifactUid}`

Retrieve an artifact by its UUID. For downloadable file-like artifacts,
returns a time-limited signed download URL. For plan artifacts, returns
the current plan content inline.

## Path parameters

- `artifactUid` string, required

## Response `200`

Artifact details with download information

- union
  - PlanArtifactResponse — Response for retrieving a plan artifact.
    - `artifact_uid` string, required — Unique identifier (UUID) for the artifact
    - `artifact_type` 'PLAN', required — Type of the artifact
    - `created_at` string, date-time, required — Timestamp when the artifact was created (RFC3339)
    - `data` PlanArtifactResponseData, required — Response data for a plan artifact, including current markdown content.
      - `document_uid` string, required — Unique identifier for the plan document
      - `notebook_uid` string, required — Unique identifier for the associated notebook
      - `url` string, uri — URL to open the plan in Warp Drive
      - `title` string — Current title of the plan
      - `content` string, required — Current markdown content of the plan
      - `content_type` string, required — MIME type of the returned plan content
  - ScreenshotArtifactResponse — Response for retrieving a screenshot artifact.
    - `artifact_uid` string, required — Unique identifier (UUID) for the artifact
    - `artifact_type` 'SCREENSHOT', required — Type of the artifact
    - `created_at` string, date-time, required — Timestamp when the artifact was created (RFC3339)
    - `data` ScreenshotArtifactResponseData, required — Response data for a screenshot artifact, including a signed download URL.
      - `download_url` string, uri, required — Time-limited signed URL to download the screenshot
      - `expires_at` string, date-time, required — Timestamp when the download URL expires (RFC3339)
      - `content_type` string, required — MIME type of the screenshot (e.g., image/png)
      - `description` string — Optional description of the screenshot
  - FileArtifactResponse — Response for retrieving a file artifact.
    - `artifact_uid` string, required — Unique identifier (UUID) for the artifact
    - `artifact_type` 'FILE', required — Type of the artifact
    - `created_at` string, date-time, required — Timestamp when the artifact was created (RFC3339)
    - `data` FileArtifactResponseData, required — Response data for a file artifact, including a signed download URL.
      - `download_url` string, uri, required — Time-limited signed URL to download the file
      - `expires_at` string, date-time, required — Timestamp when the download URL expires (RFC3339)
      - `content_type` string, required — MIME type of the uploaded file
      - `filepath` string, required — Conversation-relative filepath for the uploaded file
      - `filename` string, required — Last path component of filepath
      - `description` string — Optional description of the file
      - `size_bytes` integer — Size of the uploaded file in bytes

## Other responses

- `400` — Missing artifact UID
- `401` — Authentication required
- `403` — No permission to access artifact
- `404` — Artifact not found or unsupported artifact type

---

[API](https://skmtc.net/warp/apis/oz-agent-api.md) · [All operations](https://skmtc.net/warp/apis/oz-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/warp/oz-agent-api/versions/97be876c33e3/schema)