A GitHub Action to send arbitrary requests to GitHub's REST API
Minimal example
Name: Log latest release
on:
push:
branches:
- master
jobs:
logLatestRelease:
runs-on: ubuntu-latest
steps:
- uses: octokit/request-action@v2.x
id: get_latest_release
with:
route: GET /repos/:repository/releases/latest
repository: ${{ github.repository }}
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- run: "echo latest release: ${{ steps.get_latest_release.outputs.data }}"
More complex examples involving POST
, setting custom media types, and parsing output data
name: Check run
on:
push:
branches:
- master
jobs:
create-file:
runs-on: ubuntu-latest
steps:
# Create check run
- uses: octokit/request-action@v2.x
id: create_check_run
with:
route: POST /repos/:repository/check-runs
repository: ${{ github.repository }}
mediaType: '{"previews": ["antiope"]}'
name: "Test check run"
head_sha: ${{ github.sha }}
output: '{"title":"Test check run title","summary": "A summary of the test check run", "images": [{"alt": "Test image", "image_url": "https://octodex.github.com/images/jetpacktocat.png"}]}'
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# Update check run to completed, succesful status
- uses: octokit/request-action@v2.x
id: update_check_run
with:
route: PATCH /repos/:repository/check-runs/:check_run_id
repository: ${{ github.repository }}
mediaType: '{"previews": ["antiope"]}'
check_run_id: ${{ fromJson(steps.create_check_run.outputs.data).id }}
conclusion: "success"
status: "completed"
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
To use request body parameters, simply pass in an input
matching the parameter name. See previous examples.
To see additional debug logs, create a secret with the name: ACTIONS_STEP_DEBUG
and value true
.
octokit/request-action
is using @octokit/request
internally with the addition
that requests are automatically authenticated using the GITHUB_TOKEN
environment variable. It is required to prevent rate limiting, as all anonymous requests from the same origin count against the same low rate.
The actions sets data
output to the response data. The action also sets the headers
(again, to a JSON string) and status
output properties.
To access deep values of outputs.data
and outputs.headers
, check out the fromJson function.