1. Data
  2. Push Image Data
POST
https://api.sievedata.com/v1/push_image

Submit image data to Sieve. Images are supported via Sieve’s system by treating them as videos with single frames. Sieve ingests images in the form of URLs, which is either public or signed (private and secure). You can either submit a single image or a list of images.

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 image as a whole, along with it’s 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
image_urlstring or listValid URL to video
image_namestring or listValid name for video

Request

Terminal

            
              
              
            
            
          curl https://api.sievedata.com/v1/push_image \
  -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": amazing_project_1,
    "image_url": "https://cdn.bleacherreport.net/images_root/slides/photos/000/368/570/102184753_original.jpg?1283212258",
    "image_name": "bean"
  }'
Terminal

            
              
              
            
            
          curl https://api.sievedata.com/v1/push_image \
  -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": amazing_project_1,
    "image_url": [
      "https://cdn.bleacherreport.net/images_root/slides/photos/000/368/570/102184753_original.jpg?1283212258",
      "https://cdn.bleacherreport.net/images_root/slides/photos/000/368/570/102184753_original.jpg?1283212258"
    ]
    "image_name": ["bean", "bean1"]
  }'

Sample Response


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

            
              
              
            
            
          {
  "description": "Published images to queuing",
  "job_id": ["cb66397e-0284-4820-bdef-e9c071a39b37", "cb66397e-0284-4820-bdef-e9c071a39b38"]
}