API Reference

Create object-tracking video upload URL

Create an upload task, then upload the source video to upload_signed_url using HTTP PUT with Content-Type: application/octet-stream. The signed URL is temporary. Submit selections using Create object-tracking video task.

post/v1/videos/object-track/upload

Authorization — This endpoint requires an API key. Pass it in the api-key header on every request. Learn more

Input requirements

Videos

Formats
MP4, MOV
Maximum duration
300 seconds (5 minutes)
View all input requirements

Responses

Upload task createdObjectTrackVideoUploadResponse

FieldTypeDescription
task_idstringUnique task identifier.
statusstringUpload task status.
upload_signed_urlstringTemporary signed URL. Upload the source video with HTTP PUT.
curl -X POST "https://api.snapedit.app/v1/videos/object-track/upload" \
  -H "api-key: YOUR_API_KEY"
Response
{
  "task_id": "tracking-task-id",
  "status": "CREATED",
  "upload_signed_url": "https://storage-provider.example/signed-upload-url",
  "input_video_id": "provider__input-bucket__object-key"
}