Shield for the date of the last github action / workflow

[tsuza]

I've found a shield that shows whether an action has passed, but nothing related to the date of the latest github action. I was wondering if it was available. I wasn't able to find anything, neither in the shields.io website nor in the github endpoint list.

[calebcartwright]

Are you essentially asking for a "last invoked" badge for github actions?

[tsuza]

Yeah, you're correct.

[Zoobdude]

I'd also like this functionality. Going to see if I can build it myself.

[tsuza]

Nice, glad to see that I'm not the only one to think that!

Let me know if you get it working. I was looking for some endpoints, but I wasn't able to find any ( I might have missed it ).

[Zoobdude]

It looks like list workflow runs for a workflow (just set per_page to 1 to get the most recent run) provides the run date and time.

[chris48s]

There is some context and history to be aware of when it comes to trying to get information about github workflow runs from the api, which I collected here: #9189 (comment)
Last run of a workflow against any branch/ref should be fine (I think 🤞 ).
Last run of a workflow on the default branch or against a specific ref will have all the same problems we hit there.

[Muguett-DBY]

The existing Dynamic JSON badge can display this for a public workflow, if the creation timestamp of its newest run is what you need.

Use these fields in the badge builder:

url:   https://api.github.com/repos/OWNER/REPO/actions/workflows/WORKFLOW_FILE.yml/runs?per_page=1
query: $.workflow_runs[0].created_at
label: last run

For example, this uses Shields' own test-main.yml workflow:

I checked the unauthenticated API response against the rendered badge: both showed the same UTC timestamp. This follows the newest-created run across refs, with normal badge caching. It is not a last-success timestamp, and rerunning an older run does not turn its original created_at into the time of that new attempt.