---
title: "List recent DAG-run artifacts"
method: GET
path: "/artifacts"
tags: ["dag-runs"]
---

# List recent DAG-run artifacts

`GET /artifacts`

Returns root DAG-runs that produced artifacts, newest first, each with its files. Child runs are reached through their root.

## Query parameters

- `remoteNode` string
- `workspace` string
- `fromDate` integer — Unix timestamp in seconds
- `toDate` integer — Unix timestamp in seconds
- `name` string
- `fileName` string
- `limit` integer
- `cursor` string

## Response `200`

A successful response

- ArtifactListResponse — Page of root DAG-runs that produced artifacts, newest first
  - `items` ArtifactListItem[], required
    - `name` string, regex, required — Name of the DAG
    - `dagRunId` string, required — Unique identifier for the DAG-run. The special value 'latest' can be used to reference the most recent DAG-run.
    - `createdAt` string, required — RFC 3339 timestamp of when the DAG-run was created. This is what fromDate and toDate bound and what the listing is ordered by; for a run that waited in a queue it precedes startedAt.
    - `startedAt` string — RFC 3339 timestamp of when the DAG-run started
    - `files` ArtifactListFile[], required — Files in the run's artifact directory, sorted by path. With fileName set, only the matching files. At most 100 are returned; see filesTruncated.
      - `path` string, required — Path of the file relative to the DAG-run artifact directory
      - `size` integer, required — Size of the file in bytes
    - `filesTruncated` boolean, required — True when the run holds more files than were returned. Which files were returned is then not defined; the per-run artifact endpoint serves the full tree.
  - `nextCursor` string — Opaque cursor for the next page; absent when the last page was returned

## Other responses

- `400` — Invalid cursor, file name pattern, or pagination parameters
- `default` — Generic error response

## Changes

- **2026-09-16** (v1) `c889c95e2805` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/dagucloud/apis/dagu/changes/artifacts/get.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) · [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc.dev/dagucloud/apis/dagu/revisions/f2d1c9884f74?raw)