Direct Upload
create_upload_url_fileGenerate a signed upload URL for Shotstack ingest, then PUT your video or binary file to that URL to upload it. Requires confirmation.
Instructions
Request a signed URL to upload a file to. The response returns a signed URL that you use to upload the file to. The signed URL looks similar to:
[temporary signed credential URL omitted]
In a separate API call, use this signed URL to send a PUT request with the binary file. Using cURL you can use a command like:
curl -X PUT -T video.mp4 {data.attributes.url}
Where video.mp4 is the file you want to upload and {data.attributes.url} is the signed URL returned in the response. The request must be a PUT type.
The SDK does not currently support the PUT request. You can use the SDK to make the request for the signed URL and then use cURL to make the PUT request.
Base URL: https://api.shotstack.io/ingest/{version} Explicit confirmation is required for this exact action; provider charges, hosting, sharing or deletion may apply. Never automatically resubmit unknown outcomes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Named private Shotstack account; selects private credentials and stage/v1 environment. | |
| confirm | No | Must be true for this exact requested render, generation, mutation, upload URL or deletion. | |
| secret_result_file | Yes | New absolute JSON file in a private owner-only directory. Signed upload URL stays out of model output; no overwrite. |