film list

film list [--json]

Reads the jobs remembered by the service at FILM_URL, ordered by job identifier. It reads Film's last observations, not the renderer's current state. It neither starts a render nor refreshes existing jobs.

After configuring the caller connection and credential role, use film list to find a job identifier, then film status JOB_ID to read that job from its renderer.

Output

The plain form prints one job_id pipeline status line per job. An empty list prints no lines. --json prints the job array, including each job's available output URL, error and completion time; an empty list is []. A remembered failed job does not make the list command fail.

The list is process-local: a restarted Film has no previous job ownership records. An empty list is not proof that no renderer is still working on a job submitted before the restart.

Refusals

The command exits 1 when the connection or credentials cannot be read, the service cannot be reached, or its response cannot be read or decoded. Caller configuration refusals occur before the request is sent. An unaccepted caller secret reports film refused (401): unauthorized. Other HTTP refusals retain their status and response reason. An invalid successful response reports film at <url> answered <status> with an invalid job list: <cause>; response: <body>.

A successful list exits 0. An unsupported argument exits 2.