Download Run Node

Create a temporary download URL for a single output node's audio export. Returns a pre-signed URL for a ZIP archive containing the audio files produced by one specific output node within the run. Useful when a workflow has multiple output nodes and the caller wants only one node's results rather than the full run archive. `node_id` must identify an output-category node in the run's definition snapshot. Passing a node ID that belongs to a non-output node type (e.g. a processing or validation node) returns 404. Returns 404 if the node produced no audio files, and 409 if the run has not yet completed. The URL is valid for 15 minutes. To download all output nodes in a single archive, use `GET /runs/{run_id}/download` instead.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"
run_idstringRequiredformat: "uuid"
node_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response
dataobject
metaobject

Errors

404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error