> ## Documentation Index > Fetch the complete documentation index at: https://docs.eigenpal.com/llms.txt > Use this file to discover all available pages before exploring further. # List run artifacts > Returns a JSON list of downloadable artifact paths for a run. Pass `zip=1` to switch the response to a ZIP download containing output files. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/runs/{id}/artifacts openapi: 3.1.0 info: title: Eigenpal API version: 1.0.0 description: >- Public REST API for inspecting automations, starting and monitoring runs, managing files, collecting human reviews, and running evaluations. contact: name: Eigenpal url: https://eigenpal.com license: name: Apache-2.0 url: https://www.apache.org/licenses/LICENSE-2.0 servers: - url: https://studio.eigenpal.com description: Production security: - bearerAuth: [] tags: - name: Metadata description: Authenticate and inspect the current API context. - name: Automations description: >- Inspect runnable workflow and agent automations, their versions, triggers, and source sync state. - name: Runs description: >- Start, monitor, retry, review, and debug automation runs, including artifacts. - name: Reviews description: >- Record human review verdicts, manage corrected outputs, and monitor review health. - name: Files description: Upload reusable files for later run or dataset use. - name: Evaluation description: >- Manage datasets, examples, evaluators, experiment batches, evaluator scores, and run promotion workflows. paths: /api/v1/runs/{id}/artifacts: get: tags: - Runs summary: List run artifacts description: >- Returns a JSON list of downloadable artifact paths for a run. Pass `zip=1` to switch the response to a ZIP download containing output files. operationId: runs.artifacts.list parameters: - in: path name: id schema: type: string description: Run id required: true description: Run id - in: query name: zip schema: description: >- When `1`, download output files as a ZIP instead of listing paths. Does not include trace, scores, or input — use `GET /runs/{id}/scores` and `GET /runs/{id}/trace` for those. type: string enum: - '1' description: >- When `1`, download output files as a ZIP instead of listing paths. Does not include trace, scores, or input — use `GET /runs/{id}/scores` and `GET /runs/{id}/trace` for those. - in: query name: bundle schema: description: >- With `zip=1`, use `review` to download a ZIP with `output/` and `expected/` folders (corrected review artifacts). type: string enum: - review description: >- With `zip=1`, use `review` to download a ZIP with `output/` and `expected/` folders (corrected review artifacts). - in: query name: token schema: description: Signed email download token (zip only; no Bearer required). type: string description: Signed email download token (zip only; no Bearer required). responses: '200': description: JSON artifact list, or ZIP bytes when `zip=1`. content: application/json: schema: $ref: '#/components/schemas/RunArtifactsResponse' application/octet-stream: schema: type: string description: ZIP archive format: binary '400': description: Validation error. Request shape did not match the spec. content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' '403': description: API key lacks required scope content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' '413': description: Payload too large. Upload exceeded the per-request size cap. content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' '429': description: Rate limit exceeded headers: Retry-After: description: Seconds until the next request may succeed schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' components: schemas: RunArtifactsResponse: type: object properties: artifacts: type: array items: $ref: '#/components/schemas/RunArtifact' required: - artifacts additionalProperties: false ApiErrorEnvelope: type: object properties: issues: type: array items: $ref: '#/components/schemas/ApiErrorIssue' requestId: type: string description: Request id echoed via the x-request-id header hint: description: Suggested fix for known error patterns type: string docsUrl: description: Link to relevant docs type: string required: - issues - requestId additionalProperties: false RunArtifact: type: object properties: name: type: string role: type: string description: >- `input`, `output`, `debug`, `report`, or another stable artifact role. path: type: string description: Canonical artifact path for GET /api/v1/runs/:id/artifacts/:path. stepName: description: Workflow step that produced the file, when known. type: string contentType: anyOf: - type: string - type: 'null' size: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - name - role - path additionalProperties: false ApiErrorIssue: type: object properties: field: type: string description: JSON path of the offending field, or "" message: type: string description: Human-readable error message code: type: string description: >- Machine-readable error code (e.g. invalid_value, not_found, api_trigger_disabled, manual_trigger_disabled) severity: type: string enum: - error - warning description: Issue severity required: - field - message - code - severity additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key issued from Settings → API Keys. Pass as `Authorization: Bearer `. ````