v1
latestOpenAPI 3.1.02026-08-044257268.7 KBResources
Get a file download URL
Returns { url, expiresAt } — a short-lived signed URL for the file at path on a workspace file system; GET it to stream the bytes. Pass redirect=true for a 302 straight to the URL (curl -L). For a shareable URL with a longer TTL, run the provider's /cat endpoint.
get/v1/resources/{resourceId}/files/download-url
Path parameters
resourceIdstring required
Resource identifier (ULID).
Resource identifier (ULID).
Query parameters
pathstring required
File path relative to the FS root.
File path relative to the FS root.
redirect'true'
true answers a 302 redirect to the signed URL instead of the JSON body (the curl -L ergonomic).
true answers a 302 redirect to the signed URL instead of the JSON body (the curl -L ergonomic).
Response
The signed download URL