---
title: "List file artifacts for a run"
method: GET
path: "/runs/{runId}/files"
tags: ["Runs"]
---

# List file artifacts for a run

`GET /runs/{runId}/files`

## Request

- Base URL: `https://api.superglue.cloud/v1`
- URL: `https://api.superglue.cloud/v1/runs/{runId}/files`
- Auth: HTTP bearer

List all files promoted as downloadable output artifacts by the run,
with fresh presigned download URLs (1 hour TTL).

## Path parameters

- `runId` string, required

## Response `200`

File artifacts list

- object
  - `fileArtifacts` FileArtifact[]
    - `fileKey` string, required: Unique key identifying this file within the run
    - `filename` string, required: Original filename
    - `contentType` string, required: MIME type of the file
    - `size` integer, required: File size in bytes
    - `downloadUrl` string, uri: Pre-signed download URL, valid for 1 hour. Included in single-run and file-specific endpoints, omitted in list responses.

## Other responses

- `403`: Not authorized to read this run
- `404`: Run not found
- `503`: File storage not configured

---

[API](https://skmtc.dev/superglue/apis/superglue-api.md) - [All operations](https://skmtc.dev/superglue/apis/superglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superglue/apis/superglue-api/revisions/2d412a94bf09?raw)