export_run_output

Export completed model run outputs to a downloadable XLSX workbook or PDF table pack. Returns a time-limited pre-signed S3 download URL. Only successful runs can be exported. Supports list-of-dict (tabular) outputs; non-tabular outputs are skipped when output_name is omitted, or produce an error when named explicitly.

Parameters

Name	Type	Required	Default	Description
run_id	Annotated[str, Field(description='UUID of the completed model run to export output from.')]	Yes	—
format	Annotated[str, Field(description="Output format: 'csv', 'xlsx', or 'json'.")]	Yes	—
output_name	`Annotated[str	None, Field(description=‘Named output within the run to export.’)]`	No	None
workspace_id	`Annotated[str	None, Field(description=ID_BACKED_WORKSPACE_ID_FIELD_DESCRIPTION)]`	No	None

Returns

Returns a structured object. Top-level fields:

• run_id (string)
• model_name (string)
• format (string)
• output_names (array<string>)
• skipped_output_names (array)
• file_size_bytes (integer)
• download_url (string)
• download_url_expires_at (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "export_run_output",
  "arguments": {
    "run_id": "66666666-6666-6666-6666-666666666666",
    "format": "xlsx"
  }
}

Response

{
  "run_id": "66666666-6666-6666-6666-666666666666",
  "model_name": "forecasts",
  "format": "xlsx",
  "output_names": [
    "income_statement",
    "revenue_by_segment"
  ],
  "skipped_output_names": [],
  "file_size_bytes": 24576,
  "download_url": "https://storage.example.com/acme/forecasts/run_exports/66666666-6666-6666-6666-666666666666/all_outputs.xlsx?X-Amz-Signature=...",
  "download_url_expires_at": "2026-04-28T11:00:00+00:00"
}

Notes

• Module: Run Exports
• Requires authentication via API token or Auth0 JWT.