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

# List artifacts for a sub DAG-run

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

## Request

- Base URL: `http://localhost/api/v1`
- URL: `http://localhost/api/v1/dag-runs/{name}/{dagRunId}/sub-dag-runs/{subDAGRunId}/artifacts`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - none

Returns the artifact file tree for a specific sub 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.
- `subDAGRunId` string, required

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

## Changes

> 208 revisions in range; 1 not diffed.

- **2026-07-23** (v1) `75b8e91aaf57`: 6 warning
  - added the new `conflict` enum value to the `code` response property for the response status `404`
  - added the new `conflict` enum value to the `code` response property for the response status `default`
  - added the new `human_task_resume_failed` enum value to the `code` response property for the response status `404`
  - added the new `human_task_resume_failed` enum value to the `code` response property for the response status `default`
  - …2 more
- **2026-05-24** (v1) `8a2d5d3e9608`: 2 warning
  - added the new `rate_limited` enum value to the `code` response property for the response status `404`
  - added the new `rate_limited` enum value to the `code` response property for the response status `default`
- **2026-04-12** (v1) `39199257ecdd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dagucloud/apis/dagu/changes/dag-runs/:name/:dagRunId/sub-dag-runs/:subDAGRunId/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/742c8ecb39ce?raw)