https://github.com/beacon-biosignals/get-workflow-run
Determine the latest workflow run
https://github.com/beacon-biosignals/get-workflow-run
ci-cd github-action
Last synced: about 1 month ago
JSON representation
Determine the latest workflow run
- Host: GitHub
- URL: https://github.com/beacon-biosignals/get-workflow-run
- Owner: beacon-biosignals
- License: mit
- Created: 2025-01-09T14:49:46.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-25T16:07:01.000Z (about 1 month ago)
- Last Synced: 2025-03-25T17:23:51.813Z (about 1 month ago)
- Topics: ci-cd, github-action
- Language: Shell
- Size: 14.6 KB
- Stars: 0
- Watchers: 14
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Get Workflow Run
Determine the latest workflow run for a given workflow file and commit SHA.
## Example
```yaml
---
jobs:
test:
# These permissions are needed to:
# - Get the workflow run: https://github.com/beacon-biosignals/get-workflow-run#permissions
permissions:
actions: read
runs-on: ubuntu-latest
steps:
- uses: beacon-biosignals/get-workflow-run@v1
id: workflow
with:
workflow-file: ci.yaml
commit: ${{ github.event.pull_request.head.sha || github.sha }}
- name: Show run details
run: |
echo "${{ toJSON(steps.workflow.outputs) }}"
```
## Inputs
| Name | Description | Required | Example |
|:---------------------|:------------|:---------|:--------|
| `workflow-file` | The GitHub Actions workflow file name to target. | Yes | `ci.yaml` |
| `commit-sha` | The Git commit SHA used in the workflow run. | Yes | `23202e68ee664c345e985910770b7b9b873acfac` |
| `status` | Filter by the workflow run status. Possible status values can be [anything allowed by this API call](https://docs.github.com/en/rest/actions/workflow-runs?apiVersion=2022-11-28#list-workflow-runs-for-a-repository) and `any`. Defaults to `any`. | No | `any`, `completed`, `skipped` |
| `repository` | The repository containing the workflow run. | No | `${{ github.token }}` |
| `token` | The GitHub token used to authenticate with the GitHub API. Need when attempting to access other repositories. | No | `${{ github.token }}` |
## Outputs
| Name | Description | Example |
|:--------------|:------------|:--------|
| `workflow-id` | The GitHub API ID of the targeted workflow. | `96660010` |
| `run-id` | The workflow run ID as used by the GitHub API. | `11958836222` |
| `run-attempt` | The workflow run attempt. | `1` |
## Permissions
The following [job permissions](https://docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs) are required to run this action:
```yaml
permissions:
actions: read
```