API Reference
Get object-tracking video task status
Poll until COMPLETED or FAILED. Status progresses from CREATED to PROCESSING, then COMPLETED or FAILED.
Completed tasks include input_video_id and mask_video_id, storage identifiers for the source and aligned mask videos. These are IDs, not download URLs; reuse both in the standard removal upload endpoint. Clients should tolerate additional task metadata.
get
/v1/videos/object-track/tasks/{task_id}Authorization — This endpoint requires an API key. Pass it in the api-key header on every request. Learn more
Parameters
| Name | Type | Status | Description |
|---|---|---|---|
task_id | string | Required | Task identifier returned by the upload endpoint. |
Responses
Tracking task statusObjectTrackVideoTaskStatusResponse
| Field | Type | Description |
|---|---|---|
task_id | string | Unique task identifier. |
status | string | Task state. |
progress | integer | Task progress from 0 to 100, when available. |
input_video_id | string | Source-video storage ID, reusable with the completed mask_video_id in standard removal. |
mask_video_id | string | Aligned mask-video storage ID. Available on completed tracking tasks; reusable in standard removal. |
curl -X GET "https://api.snapedit.app/v1/videos/object-track/tasks/YOUR_TASK_ID" \
-H "api-key: YOUR_API_KEY"Response
{
"task_id": "tracking-task-id",
"status": "COMPLETED",
"progress": 100,
"input_video_id": "provider__input-bucket__object-key",
"mask_video_id": "provider__result-bucket__object-key"
}