Job History

Show the execution history a given job (or list of jobs for a project) either in descending order of execution time or by job run ID.

Syntax

execution history of job <job reference> [from "<start>" [to "<end>"]] [limit <limit> [offset <offset>]]

job execution history by id <job run uuid> [from "<start>" [to "<end>"]]

execution history of project <project reference> [from "<start>" [to "<end>"]] [limit <limit> [offset <offset>]]

Parameters

job reference

String — Name of the job to show history for, optionally qualified by project.

start

String — ISO-8601 formatted string including the timezone, such as 2021-04-29T08:12:23Z. If the timezone is omitted, it will default to UTC. If the time and time zone portions are omitted, it will default to T00:00:00. The provided time must be before end, and it must be in the past.

Default: unset — history is returned from the earliest available record.

end

String — ISO-8601 formatted string including the timezone, such as 2021-04-29T08:12:23Z. If the timezone is omitted, it will default to UTC. If the time and time zone portions are omitted, it will default to T00:00:00. Can only be used if start is explicitly defined. Default: unset — history is returned up to the most recent record.

limit

Integer — Maximum number of job history results to show. Default: 50.

offset

Integer — Number of results to omit from the beginning of the query, allowing farther past records to be queried. Default: 0.

job run uuid

UUID — The ID of a specific job run to show.

project reference

String — The name of the project containing the jobs you want to see the history for.