Core APIs

Unified Jobs

List and inspect both video and split jobs from a single API. Use type-specific routes when you need signed download URLs.

List jobs

GET https://api.flikly.ai/api/v1/developer/jobs returns cursor-paginated results.

  • typevideo or split
  • status — queued, processing, completed, failed, cancelled, expired
  • created_after / created_before — ISO-8601 datetimes
  • metadata_external_id — filter by metadata.external_id
  • limit — 1–100 (default 25)
  • cursor — opaque cursor from pagination.next_cursor

Get job detail

GET /jobs/{id} accepts video_job_* or split_job_* ids.

No signed URLs from /jobs

Unified responses include availability flags and API paths (e.g. result_url, clips_url) — not presigned storage URLs. Fetch downloads from:

  • /video-jobs/{id}/result
  • /split-jobs/{id}/clips or /result

Scope: jobs:read.