get generation download url

Obtain the available full output of a completed generation in your organization. Authenticate with x-api-key; no Studio project or user session is required. Any valid API key belonging to the generation’s organization can request the URL.

The successful response is an unquoted URL in a text/plain body, not JSON, a redirect, or the video itself. Fetch that URL separately without forwarding your API key.

download_url=$(curl --fail-with-body --silent --show-error \
  -H "x-api-key: $SYNC_API_KEY" \
  "https://api.sync.so/v2/generations/$GENERATION_ID/download") &&
curl --fail --location "$download_url" --output output.mov

The URL resolves an existing output using your organization’s current plan and billing-version eligibility. Free and watermark-required plans receive the watermarked derivative when present. Entitled plans (such as v2 Creator and v3 Starter or higher) receive the clean output when available. Historical outputs can have the watermark burned in, so an upgrade does not guarantee every old output becomes watermark-free. Changing plans does not rewrite historical files. This endpoint does not generate a new render or remove burned-in watermarks.

Signed URLs can expire or become unavailable before their nominal validity. Request this endpoint again for a fresh URL while the output is still available. These URLs are download credentials: keep them private.

Errors use the standard JSON error body and stable errorCode:

Authentication also returns 422 for draft organizations. Requesting a download URL does not create a project, incur a generation charge, or restore deleted files.