1. Data
  2. Push Video Data
POST
https://api.sievedata.com/v1/push_video

Submit video data to Sieve. Sieve ingests videos in the form of URLs, which is either public or signed (private and secure).

Learn more about signed URLs for AWS or GCP at the respective links. In addition, you need to supply a unique video name for each video. Optionally, you can also submit custom metadata for the video as a whole, along with its associated value. For example, if you have internal indexes or fields you want to track with our platform, this would be an easy way for you to access those within Sieve as well.

Parameters

ParameterTypeDescription
project_namestringThe name of the project
video_urlstringValid URL to video
video_namestringValid name for video
user_metadataJSON object with string keys and values (optional)All user-specified metadata

Request

Terminal

            
              
              
            
            
          curl https://api.sievedata.com/v1/push_video \
  -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": amazing_project_1,
    "video_url": "https://storage.googleapis.com/sieve-data-video-test-bucket/PRG1.avi",
    "video_name": "YOUR_VIDEO_NAME"
    "user_metadata": {"per_video_metadata_1": "your_val", "per_video_metadata_2": "your_other_val"}
  }'

Sample Response


            
              
              
            
            
          {
    "description": "Published video to queuing",
    "job_id": "cb66397e-0284-4820-bdef-e9c071a39b37"
}