Skip to main content
GET
Get Workflow Run File URL
Use the id of a fileRef returned by the workflow’s final output as the file_id query parameter. The response contains a signed download URL valid for ten minutes. Follow redirects when fetching the URL, and treat the URL as a temporary credential.

Authentication and scope

Requires workflow-runs-output-read for files in the final output of a completed run, or workflows-read for general runtime file access. The token owner must be a workspace administrator, and any workspace restriction on the token must match. The permission does not restrict access to runs created by that particular token. Temporary output ZIPs, PDFs and other fileRef values do not need to be persisted as workspace documents. Persisted documentRef values use the separate workspace document API and its permissions.

Availability

For output-only access, an unfinished run or a file not present in the final output returns 404. Files from another run require a validated internal alias; including an arbitrary file reference in JSON does not grant access. An expired signed link returns 401. Request a new URL through this endpoint while the stored file remains available. The download can return 404 if the file has been removed; issuing a link does not extend file retention.

Authorizations

Authorization
string
header
required

Personal Access Token created from the Raydocs dashboard. Include in the Authorization header: Bearer <your_token> See API Keys for token creation and management.

Path Parameters

workspaceId
integer
required
workflowId
string<uuid>
required
runId
string<uuid>
required

Query Parameters

file_id
string
required

ID of the temporary fileRef to download.

Response

Temporary download URL. File availability is checked when downloading.

url
string<uri>
required