API Reference
Get remove-object video task status
Poll until COMPLETED or FAILED. Status progresses from CREATED to PROCESSING, then COMPLETED or FAILED. Completed tasks include download_signed_url, a temporary signed URL for the processed video. Download or copy the result before the URL expires. Clients should tolerate additional task metadata.
get
/v1/videos/remove-object/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
Removal task statusRemoveObjectVideoTaskStatusResponse
| Field | Type | Description |
|---|---|---|
task_id | string | Unique task identifier. |
status | string | Task state. |
progress | integer | Task progress from 0 to 100, when available. |
download_signed_url | string | Temporary signed download URL for the processed video when COMPLETED. Download or copy before it expires. |
curl -X GET "https://api.snapedit.app/v1/videos/remove-object/tasks/YOUR_TASK_ID" \
-H "api-key: YOUR_API_KEY"Response
{
"task_id": "removal-task-id",
"status": "COMPLETED",
"progress": 100,
"download_signed_url": "https://storage-provider.example/signed-result-url"
}