---
title: "List artifacts for a DAG-run"
method: GET
path: "/dag-runs/{name}/{dagRunId}/artifacts"
tags: ["dag-runs"]
---

# List artifacts for a DAG-run

`GET /dag-runs/{name}/{dagRunId}/artifacts`

Returns the artifact file tree for a DAG-run

## Path parameters

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

## Query parameters

- `remoteNode` string
- `recursive` boolean

## Response `200`

Artifact tree retrieved successfully

- ArtifactTreeResponse — Artifact tree for a DAG-run
  - `items` ArtifactTreeNode[], required
    - `name` string, required — Display name of the artifact entry
    - `path` string, required — Relative path of the artifact entry within the artifact directory
    - `type` 'directory' | 'file', required — Artifact tree node type
    - `size` integer — Size of the artifact file in bytes
    - `children` ArtifactTreeNode[] — Nested artifact entries when this node is a directory

## Other responses

- `404` — Artifact directory not found
- `default` — Generic error response

---

[API](https://skmtc.net/dagucloud/apis/dagu.md) · [All operations](https://skmtc.net/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/93cc41f2018a/schema)