> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# List Run Artifacts
> List all artifact files (recordings, logs, deliverables) produced by a single run. Each entry includes a download URL pointing back to the Get Artifact File endpoint.
**Permission Required**: any API key scoped to the project that owns the run
Artifact endpoints are served by the **bouncer** service at
`https://bouncer.nunu.ai`, not the main `nunu.ai/api/v1` host. Use the same
`X-Api-Key` header for authentication.
Return the list of artifact files produced by a run, including recordings,
device logs, and any custom files written by the agent during the run. Each
entry includes a download URL that points back to the
[Get Artifact File](/api-reference/artifacts/get-artifact) endpoint.
## Path Parameters
Composite run ID, in the format `{multiplayerRunId}-{playerNumber}` (for
example `lkkg6t5612m-1`). This is the ID returned in the `players[].id` field
of [Get Run](/api-reference/runs/get-run).
## Response
Echo of the path parameter.
Number of artifacts returned.
List of artifact entries.
Artifact filename, including any subdirectories the agent created (for
example `deliverables/report.json`).
Absolute URL to download the artifact. Authenticate the same way you
authenticated this list call.
File size in bytes.
ISO 8601 timestamp when the artifact was written to storage.
Object ETag, useful for caching and conditional requests.
```bash cURL theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl -X GET "https://bouncer.nunu.ai/runs/lkkg6t5612m-1/artifacts" \
-H "X-Api-Key: YOUR_API_TOKEN"
```
```typescript JavaScript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const runId = "lkkg6t5612m-1";
const response = await fetch(
`https://bouncer.nunu.ai/runs/${runId}/artifacts`,
{
headers: {
"X-Api-Key": process.env.NUNU_API_TOKEN,
},
}
);
const data = await response.json();
```
```python Python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import requests
import os
run_id = "lkkg6t5612m-1"
response = requests.get(
f"https://bouncer.nunu.ai/runs/{run_id}/artifacts",
headers={"X-Api-Key": os.environ["NUNU_API_TOKEN"]},
)
data = response.json()
```
```json 200 theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
"runId": "lkkg6t5612m-1",
"count": 3,
"artifacts": [
{
"filename": "recording.mp4",
"url": "https://bouncer.nunu.ai/runs/lkkg6t5612m-1/artifacts/recording.mp4",
"size": 15728640,
"uploaded": "2026-03-03T15:55:00.000Z",
"etag": "9a3b4c5d6e7f8090a1b2c3d4e5f60718"
},
{
"filename": "device_log.log",
"url": "https://bouncer.nunu.ai/runs/lkkg6t5612m-1/artifacts/device_log.log",
"size": 45678,
"uploaded": "2026-03-03T15:55:00.000Z",
"etag": "0a1b2c3d4e5f60718a3b4c5d6e7f8090"
},
{
"filename": "deliverables/custom-report.json",
"url": "https://bouncer.nunu.ai/runs/lkkg6t5612m-1/artifacts/deliverables/custom-report.json",
"size": 2048,
"uploaded": "2026-03-03T15:55:00.000Z",
"etag": "1b2c3d4e5f60718a3b4c5d6e7f80909a"
}
]
}
```
## OpenAPI
````yaml GET /runs/{runId}/artifacts
openapi: 3.1.0
info:
title: nunu.ai API
description: >-
The nunu.ai Public API allows you to programmatically interact with your
projects, manage test runs, and upload builds.
version: 1.0.0
servers:
- url: https://nunu.ai/api/v1
security:
- apiKeyAuth: []
paths:
/runs/{runId}/artifacts:
servers:
- url: https://bouncer.nunu.ai
description: Bouncer service (artifact and knowledge delivery)
get:
tags:
- Artifacts
summary: List Run Artifacts
description: >-
List all artifact files (recordings, logs, deliverables) produced by a
single run. Each entry includes a download URL pointing back to the Get
Artifact File endpoint.
operationId: listRunArtifacts
parameters:
- name: runId
in: path
required: true
description: >-
Composite run ID, in the format {multiplayerRunId}-{playerNumber}
(e.g. lkkg6t5612m-1).
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListRunArtifactsResponse'
'401':
description: Unauthorized - missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden - API key does not match the run's project
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Run not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
ListRunArtifactsResponse:
type: object
required:
- artifacts
properties:
runId:
type: string
description: Echo of the path parameter. Omitted when the run has no artifacts.
count:
type: integer
description: Number of artifacts returned. Omitted when the run has no artifacts.
artifacts:
type: array
items:
$ref: '#/components/schemas/RunArtifact'
Error:
type: object
properties:
error:
type: string
code:
type: string
details:
type: object
RunArtifact:
type: object
required:
- filename
- url
- size
- uploaded
- etag
properties:
filename:
type: string
description: >-
Artifact filename, including any subdirectories the agent created
(e.g. deliverables/report.json).
url:
type: string
description: >-
Absolute URL to download the artifact. Authenticate the same way you
authenticated this list call.
size:
type: integer
description: File size in bytes.
uploaded:
type: string
format: date-time
description: ISO 8601 timestamp when the artifact was written to storage.
etag:
type: string
description: Object ETag, useful for caching and conditional requests.
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
description: API key for authentication
````