billing

Create a new cost center

Changed on

Creates a new cost center for an enterprise. Enterprise owners and billing managers can create cost centers. A custom role holder with fine-grained write access to enterprise billing can also create cost centers. An installation access token for a GitHub App installed on the enterprise with write access to enterprise billing can create cost centers in the enterprise.

post/enterprises/{enterprise}/settings/billing/cost-centers

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/enterprises/{enterprise}/settings/billing/cost-centers
  • Auth: none declared

Path parameters

enterprisestring required

The slug version of the enterprise name.

Request body

namestring required

The name of the cost center (max length 255 characters)

ai_credit_pool_enabledboolean

Whether the cost center draws from the AI credit pool.

This can only be enabled for cost centers that contain only user or team resources.

  • false — no cap; the cost center draws from the shared enterprise pool.
  • true — the cost center is capped at an amount derived from its members' license entitlements.

Response

Cost center created successfully

idstring

Unique identifier for the cost center

namestring

Name of the cost center

azure_subscriptionstring nullable

Azure subscription ID associated with the cost center. Only present for cost centers linked to Azure subscriptions.

state'active' | 'deleted'

State of the cost center.

ai_credit_pool_enabledboolean

Whether the cost center draws from the AI credit pool (capped from member license entitlements).

Changes

  • 2022-11-28eccf40a54a3cRevision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status