post https://api.pixop.com/api/v1/videos//out/s3
Initiates an asynchronous multipart copy operation to transfer video data from the Pixop Platform to the specified S3 bucket.
- The video data is not ready for copy until the processing task is complete.
You can check the status of the processing task using GET /v1/videos/{videoId}/processing/status (or GET /v1/videos/{videoId}/in/status for a "video in" copy operation), or subscribe toclip_processing,video_processingorvideo_inwebhooks to receive real-time updates.
The status of this operation can be tracked using:
-
GET /v1/videos/{videoId} (for full video details)
-
Webhooks: Subscribe to
video_outevents to receive real-time updates -
When the operation succeeds, the status updates to
DONE. If it fails, the status updates toFAILED.
Retry and Abandon Options:
- Restart a
FAILEDoperation usingPOST /v1/videos/{videoId}/out/restart. - Abandon a
FAILEDoperation and free up resources usingPOST /v1/videos/{videoId}/out/abandon.
Notes:
- Only one "video out" operation can run per video at a time. Starting a new operation will result in a
409 Conflictresponse. - If the specified object key already exists in the S3 bucket, or if the video data is not ready for copy, a
409 Conflictresponse is also returned.
