Skip to content

docs: surface cost attribution a bit more + link to api #2590

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Pierrci merged 5 commits into from
Jun 26, 2026
Merged

docs: surface cost attribution a bit more + link to api #2590

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
a45c01e
docs: document cost attribution for resource groups
Pierrci Jun 24, 2026
a7fa001
fix: URL-encode braces in resource groups billing API link
Pierrci Jun 24, 2026
d78d4bc
fix(docs): escape braces in resource groups billing API link as HTML
Pierrci Jun 24, 2026
f595b04
docs: simplify resource groups billing API link
Pierrci Jun 24, 2026
44966b3
fix(docs): restore encoded braces in billing API link
Pierrci Jun 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/hub/enterprise-resource-groups.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ This feature allows organization administrators to:
- Keep private repositories visible only to authorized group members
- Enable multiple teams to work independently within the same organization
- Configure which member roles are allowed to create new resource groups
- Attribute costs to specific resource groups for better budget management

This Team & Enterprise feature helps organizations manage complex team structures and maintain proper access control over their repositories.

Expand Down
2 changes: 2 additions & 0 deletions docs/hub/security-resource-groups.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,8 @@ Resource Groups also serve as a cost attribution unit for compute services. When
- **Inference Providers**: pass the resource group's ID via the `X-HF-Bill-To` header (or `bill_to` parameter in the SDK). See [Billing for Team and Enterprise organizations](/docs/inference-providers/pricing#billing-for-team-and-enterprise-organizations).
- **Inference Endpoints**: cost is automatically attributed to the resource group the model repository belongs to. Endpoints instantiated directly from the built-in Inference Endpoints catalog aren't supported at this time.

You can use the <a href="https://huggingface.co/spaces/huggingface/openapi#tag/orgs/GET/api/organizations/&#123;name&#125;/billing/usage-by-resource-group">dedicated API endpoint</a> to retrieve cost attribution data for resource groups.

## Resource Groups API

You can list resource groups and add users to them (or change a member's org role and resource group assignments) via the Hub API. For the full reference, examples, and batch workflows, see the [Programmatic User Access Control Management](./programmatic-user-access-control) guide.
Loading