Movies

List a movie's file transfers

GET/movies/{id}/jobs/

read Read: looks, changes nothing. Scopes

The movie's latest 20 file transfers, newest first. Not paged.

Path parameters

  • idstring (uuid)required

    The movie's id.

Response

200 OK

  • idstring (uuid)requiredread-only
  • media_filestring (uuid)requiredread-only
  • titleobjectrequiredread-onlycan be null

    The title behind this job, for an operator-legible queue.

    kind is the title's model (movie, episode) and id its key, so the queue can link to the right page. Null while the file exists but no catalogue entry points at it. Reached through the media file's reverse one-to-one; the list view selects those relations so this costs no query per row.

  • serverstring (uuid)requiredread-only
  • server_namestringrequiredread-only
  • methodstringrequiredread-only
  • source_refanyrequiredread-only

    Method-specific locator: the URL to pull, the watch-folder path, the bucket and key of an object, the peer node for a replication. An object is recorded by its key and signed only when the job is sent to the node — a queued job can wait longer than any signed URL lives — and the node receives an ordinary HTTPS URL, so it needs no cloud SDK and object storage is just a URL pull.

  • statestringrequiredread-only
  • phasestringrequiredread-only

    What the node is doing right now: waiting for a free slot, downloading, uploading, probing, publishing.

  • progress_pctintegerrequiredread-only
  • bytes_doneintegerrequiredread-only
  • bytes_totalintegerrequiredread-only
  • errorstringrequiredread-only
  • attemptsintegerrequiredread-only
  • created_atstring (date-time)requiredread-only
  • started_atstring (date-time)requiredread-onlycan be null
  • finished_atstring (date-time)requiredread-onlycan be null

Errors

  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means