Jobs

A job's record and fresh signed URLs for its files, within 24 hours. For a queued job, the poll.

A queued job (video_still, video_render, raster_render, and a large pull_analyse, pull_twin or pull_lab) reads queued, running, ok, refused, failed, cancelled or expired. A queued pull job's result is its verdict, and its whole report is the file report.json. Once ok, its files come as signed URLs that work for 15 minutes; ask again for fresh ones until the files are deleted, 24 hours after the job finished (then expired). wait holds the answer until the job ends or that many seconds pass, at most 25.

get/api/agents/jobs/{job}

Request

  • Base URL: https://tomorrowlives.com
  • URL: https://tomorrowlives.com/api/agents/jobs/{job}
  • Auth: HTTP bearer

Path parameters

jobstring required

Query parameters

waitinteger

Seconds to hold the answer while a queued job runs

Response

The job

jobstring
verbstring
unitsinteger

The price while it waits or runs; once it ends, what it was charged

status'queued' | 'running' | 'ok' | 'refused' | 'failed' | 'cancelled' | 'expired'
queuedboolean
created_atstring date-time
started_atstring date-time nullable
finished_atstring date-time nullable
retry_after_sinteger

While queued or running: when to ask again

resultunknown
errorstring
messagestring
http_statusinteger

For refused or failed: the status an immediate call would have had

files_expire_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.