Skip to main content

Task History

Show the execution history a given task either in descending order of execution time or by run ID.

Syntax​

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

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

Parameters​

task reference​

String — Name of the task to show history for, qualified by job and 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 task 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.

task run uuid​

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