> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superglue.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# List file artifacts for a run

> List all file artifacts produced by a run's output transform,
with fresh presigned download URLs (1 hour TTL).




## OpenAPI

````yaml /openapi.yaml get /runs/{runId}/files
openapi: 3.0.0
info:
  title: superglue AI API
  version: 1.0.0
  description: API for running superglue AI tools
  contact:
    name: superglue AI Support
    email: stefan@superglue.ai
servers:
  - url: https://api.superglue.ai/v1
    description: Production
security:
  - ApiKeyAuth: []
paths:
  /runs/{runId}/files:
    get:
      tags:
        - Runs
      summary: List file artifacts for a run
      description: |
        List all file artifacts produced by a run's output transform,
        with fresh presigned download URLs (1 hour TTL).
      operationId: listRunFiles
      parameters:
        - name: runId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: File artifacts list
          content:
            application/json:
              schema:
                type: object
                properties:
                  fileArtifacts:
                    type: array
                    items:
                      $ref: '#/components/schemas/FileArtifact'
        '404':
          description: Run not found
        '503':
          description: File storage not configured
components:
  schemas:
    FileArtifact:
      type: object
      description: A downloadable file artifact produced by a tool
      required:
        - fileKey
        - filename
        - contentType
        - size
      properties:
        fileKey:
          type: string
          description: Unique key identifying this file within the run
          example: report
        filename:
          type: string
          description: Original filename
          example: monthly_report.csv
        contentType:
          type: string
          description: MIME type of the file
          example: text/csv
        size:
          type: integer
          description: File size in bytes
          example: 52480
        downloadUrl:
          type: string
          format: uri
          description: >-
            Pre-signed download URL, valid for 1 hour. Included in single-run
            and file-specific endpoints, omitted in list responses.
          example: >-
            https://s3.amazonaws.com/bucket/org/run-files/runId/report.csv?X-Amz-Expires=3600
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: Static API Key
      description: >
        Static API key authentication using Bearer token scheme.

        Include your API key in the Authorization header: `Authorization: Bearer
        YOUR_API_KEY`


        Alternatively, you can use the `token` query parameter to authenticate.


        API keys can be generated in your superglue dashboard.

````