Skip to main content
GET
/
api
/
tasks
/
List Tasks
curl --request GET \
  --url https://api.example.com/api/tasks/
[
  {
    "id": "<string>",
    "asset_id": "<string>",
    "celery_task_id": "<string>",
    "result": "<string>",
    "error_message": "<string>",
    "retry_count": 123,
    "created_at": "<string>",
    "started_at": "<string>",
    "completed_at": "<string>"
  }
]

Query Parameters

​
library_id
string | null

Restrict results to tasks owned by this library. When omitted, returns tasks across every library the authenticated user owns.

​
status
enum<string> | null

Status of a background task execution.

Available options:
pending,
started,
success,
failure
​
task_type
enum<string> | null
Available options:
image_quality,
embedding,
face_detection,
face_clustering,
asset_description,
asset_storage_cleanup,
reverse_geocoding,
video_thumbnail_extract,
video_metadata_extract,
thumbhash,
display_proxy_generation
​
limit
integer
default:20
Required range: 1 <= x <= 200

Response

Successful Response

​
id
string
required
​
asset_id
string | null
required
​
task_type
enum<string>
required
Available options:
image_quality,
embedding,
face_detection,
face_clustering,
asset_description,
asset_storage_cleanup,
reverse_geocoding,
video_thumbnail_extract,
video_metadata_extract,
thumbhash,
display_proxy_generation
​
celery_task_id
string
required
​
status
enum<string>
required

Status of a background task execution.

Available options:
pending,
started,
success,
failure
​
result
string | null
required
​
error_message
string | null
required
​
retry_count
integer
required
​
created_at
string
required
​
started_at
string | null
required
​
completed_at
string | null
required