---
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.

Public artifacts can be read without authentication; private artifacts
require the caller to be authenticated and authorized. Anonymous reads
of public file artifacts omit the `filepath` field.

## 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 — Conversation-relative filepath for the uploaded file. Omitted for anonymous reads of public artifacts.
      - `filename` string, required — Last path component of filepath
      - `title` string — Short, badge-visible label for the artifact. For recording artifacts, this is the agent-authored title shown in Oz web and blocklist badges. Distinct from description, which is longer and shown in detail views.
      - `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 for private artifacts
- `403` — No permission to access private artifact
- `404` — Artifact not found or unsupported artifact type

---

[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-service-production.skmtc.workers.dev/v1/apis/warp/oz-agent-api/revisions/a0daf9e59774/schema)