Seat Count
ActionsTags
(2)A simple Action to count the remaining seats in an organization. It is intended to be used in conjunction with other actions to do something like notify the user when there are less than 10 seats remaining.
Create a workflow (eg: .github/workflows/on-issue-pr-open.yml
). See Creating a Workflow file.
You will need to create a PAT(Personal Access Token) that has admin:org
access.
Add this PAT as a secret so we can use it as input github-token
, see Creating encrypted secrets for a repository.
If your organization has SAML enabled you must authorize the PAT, see Authorizing a personal access token for use with SAML single sign-on.
name: Check Seat Count
on:
schedule:
- cron: 0 0 * * *
jobs:
run:
runs-on: ubuntu-latest
steps:
- uses: austenstone/seat-count-action@main
id: seats
with:
github-token: ${{secrets.TOKEN}}
outputs:
percentage: ${{steps.seats.outputs.percentage}}
remaining: ${{steps.seats.outputs.remaining}}
more-than-90-percent:
needs: [seats]
if: needs.seats.outputs.percentage > 90
runs-on: ubuntu-latest
steps:
- run: echo More than 90% of seats used!
Various inputs are defined in action.yml
:
Name | Description | Default |
---|---|---|
github‑token | Token to use to authorize. | ${{ github.token }} |
org | The org to use for the action. | ${{ github.event.organization.login }} |
Name | Description |
---|---|
filled_seats | The number of filled seats. |
seats | The total number of seats. |
percentage | Threshold percentage of seats. |
remaining | Threshold remaining seats. |
name | The name of the plan. |
space | The package space remaining. |
private_repos | The number of private repos. |
To get more help on the Actions see documentation.
Seat Count is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.