---
title: "List a user's artifacts"
method: GET
path: "/api/v1/users/{user}/artifacts"
---

# List a user's artifacts

`GET /api/v1/users/{user}/artifacts`

Returns all artifacts owned by the specified user. Artifacts represent
AI-generated or user-uploaded files associated with agent sessions,
threads, or sandboxes — such as images, documents, and code outputs.

The authenticated user must be requesting their own artifacts or must
have administrative access. Attempting to list artifacts for a user
the caller is not authorized to access returns 403.

Results are returned in a single page without cursor pagination. Each
artifact in the response reflects the state of its current version,
including a short-lived signed `file_url` for direct download.

## Path parameters

- `user` string, required

## Response `200`

Successful response

- object — All artifacts owned by the user.
  - `data` object[], required — Array of artifact objects belonging to the user.
    - `agent` string — ID of the agent that produced this artifact (`agt_...`). `null` if not agent-produced.
    - `content_type` string — MIME type of the current version's file, e.g. `"text/csv"` or `"image/png"`. `null` if no file is attached.
    - `created_at` string, date-time — When the artifact was first created (ISO 8601).
    - `current_version` string — ID of the current (latest published) artifact version (`artv_...`). `null` if no version has been published.
    - `description` string — Optional longer description of the artifact's contents or purpose. `null` if not set.
    - `file` string — Storage file ID for the current version (`fil_...`). `null` if no file is attached.
    - `file_name` string — Original filename of the current version's file, e.g. `"output.csv"`. `null` if no file is attached.
    - `file_url` string — Short-lived signed URL for downloading the current version's file. `null` if no file is attached.
    - `id` string, required — Artifact ID (`art_...`).
    - `image_source` object — Image source metadata for rendering the current version's file inline. Present only when `content_type` starts with `"image/"`. `null` otherwise.
      - `file` string — ID of the underlying storage file (`fil_...`). `null` when the image is not backed by a platform storage file.
      - `height` integer — Height of the image in pixels. `null` if not known.
      - `media` string — ID of the associated media record (`med_...`). `null` when the image is not linked to a media entity.
      - `mime_type` string — MIME type of the image, e.g. `"image/png"` or `"image/jpeg"`. `null` if not known.
      - `refresh_url` string — Endpoint URL you can call to obtain a fresh signed `url` when the current one has expired. `null` if the URL does not require refreshing.
      - `url` string — Signed or public URL for downloading the image. May be time-limited; use `refresh_url` to obtain a new URL when this one expires.
      - `width` integer — Width of the image in pixels. `null` if not known.
    - `name` string — Human-readable name for the artifact, e.g. `"Q2 Report"`. `null` if not set.
    - `org` string — ID of the organization this artifact belongs to (`org_...`).
    - `sandbox` string — Identifier of the sandbox environment associated with this artifact. `null` if not sandbox-scoped.
    - `team` string — ID of the team that owns this artifact (`tea_...`). `null` if not team-scoped.
    - `thread` string — ID of the thread in which this artifact was created (`thr_...`). `null` if not thread-scoped.
    - `updated_at` string, date-time — When the artifact record was last modified (ISO 8601).
    - `user` string — ID of the user who created this artifact (`usr_...`). `null` if not user-scoped.
    - `version` integer — Current version number of the artifact. Increments each time a new version is published.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)