CostMonStart free

Connector docs — GitHub

Exactly what CostMon asks for to read GitHub

CostMon calls GitHub's billing usage report for either an organization or an enterprise, scoped to the read-only Administration permission.

See the security model →See the solution page →

What CostMon calls

The literal API surface, nothing more

GET /organizations/{org}/settings/billing/usage
Org-scoped Actions and Copilot usage, by month.
GET /enterprises/{enterprise}/settings/billing/usage
Enterprise-scoped usage, when scope="enterprise".

What you supply

Credential and config fields

tokenTokensecretrequired

The org usage endpoint accepts a fine-grained PAT with "Administration: read" (or a GitHub App installation token). The enterprise usage endpoint requires a classic PAT with the "admin:enterprise" scope — fine-grained tokens are not accepted there.

orgOrganizationrequired

The GitHub organization login to report usage for.

enterpriseEnterpriseoptional

Enterprise slug. Required when scope is "enterprise"; ignored otherwise.

scopeScopeoptional

"org" (default) or "enterprise". Enterprise scope reports at the enterprise level and requires a classic PAT.

Minimum permission

Copy this, not a broader role

Minimum token scope
Org scope:        fine-grained PAT, "Administration: read"
Enterprise scope: classic PAT, "admin:enterprise" scope
                  (fine-grained tokens aren't accepted here)

Scope of access

What GitHub access can't reach

  • Repository contents, code, or issues
  • Actions workflow logs or Copilot suggestion content, only aggregate usage

FAQ

Common questions about the GitHub connector

Will a fine-grained PAT work for enterprise-scoped billing?

No. GitHub's enterprise usage endpoint only accepts a classic PAT with admin:enterprise. Fine-grained tokens work for the org-scoped endpoint only.

Does this token give CostMon access to my repositories?

No. Administration: read on the org (or admin:enterprise for enterprise scope) covers billing usage reporting, not repository contents.

A rate you looked up will change again.

Provider pricing pages change without notice. CostMon tracks the bill that pays for it.

Start freeSee recent price changes
Esc