---
title: "List artifacts"
method: GET
path: "/agents/{agent_id}/artifacts"
tags: ["Artifacts"]
---

# List artifacts

`GET /agents/{agent_id}/artifacts`

List artifacts (files) produced by an agent. Optionally scope to a specific session, search by filename, sort, and paginate.

## Path parameters

- `agent_id` string, required

## Query parameters

- `session_id` string
- `search_query` string
- `sort_order` string
- `page_size` integer
- `cursor` string

## Response `200`

Artifacts matching the provided filters.

- object
  - `artifacts` object[]
    - `id` string — Unique artifact identifier.
    - `version_id` string, nullable — ID of this specific artifact version.
    - `major_version` integer, nullable
    - `agent_id` string, nullable — ID of the agent that produced the artifact.
    - `session_id` string, nullable — ID of the session in which the artifact was produced.
    - `filename` string, nullable
    - `created_at` string, date-time, nullable — ISO 8601 timestamp of when the artifact version was created.
    - `metadata` object — Arbitrary metadata stored with the artifact version.
    - `url` string, nullable — Signed URL for direct access to the artifact file.
    - `creator` object, nullable — The user who created this artifact version. `null` when unknown.
      - `id` string, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `email` string, nullable
      - `profile_picture` string, nullable
  - `next_cursor` string, nullable — Cursor to pass as `cursor` on the next request. `null` when there are no more results.

## Other responses

- `400` — Bad request — `page_size` is not an integer.
- `401` — Unauthorized — missing or invalid API key.
- `403` — Forbidden — the caller does not have read access on the agent.
- `404` — Agent not found.
- `500` — Internal server error.

---

[API](https://skmtc.dev/gumloop/apis/public-api.md) · [All operations](https://skmtc.dev/gumloop/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gumloop/public-api/revisions/115f2d6ce387/schema)