{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Creates a new budget for an organization. The authenticated user must be an\norganization admin or billing manager.","properties":{"path":{"type":"object","properties":{"org":{"type":"string","description":"The organization name. The name is not case sensitive."}},"required":["org"],"additionalProperties":false},"body":{"type":"object","properties":{"budget_amount":{"type":"integer","description":"The budget amount in whole dollars. For license-based products, this represents the number of licenses."},"prevent_further_usage":{"type":"boolean","description":"Whether to prevent additional spending once the budget is exceeded. For `user` and `multi_user_customer` scopes, this must be `true`."},"budget_alerting":{"type":"object","properties":{"will_alert":{"type":"boolean","description":"Whether alerts are enabled for this budget. Rejected for user-scope as alerting is always disabled for them."},"alert_recipients":{"type":"array","items":{"type":"string"},"description":"Array of user login names who will receive alerts. Rejected for user-scope as alerting is always disabled for them."}}},"budget_scope":{"type":"string","description":"The scope of the budget for this organization.\n\n- `organization`: Apply the budget to the organization.\n- `repository`: Apply the budget to a specific repository in the organization.\n- `multi_user_customer`: Apply a universal budget to all users in the organization.\n- `user`: Apply the budget to a single user in the organization.\n\n`user` and `multi_user_customer` scopes are only supported when\n`budget_product_sku` is `ai_credits` or `premium_requests`.","enum":["organization","repository","multi_user_customer","user"]},"budget_entity_name":{"type":"string","description":"The entity to apply the budget to. The expected value depends on `budget_scope`.\n\n- `repository`: The repository name, or `owner/repo`.\n- `organization`, `multi_user_customer`, and `user`: Not used. For `user`, set the `user` field instead.","default":""},"budget_type":{"description":"The type of pricing model used by the budget. Determines how `budget_product_sku` is interpreted.\n\n- `BundlePricing`: Covers all AI credit SKUs. Set `budget_product_sku` to `ai_credits`.\n- `ProductPricing`: Covers all SKUs that belong to a product. Set `budget_product_sku` to a product such as `actions` or `packages`.\n- `SkuPricing`: Covers a single, specific SKU. Set `budget_product_sku` to a SKU such as `actions_linux`.","oneOf":[{"type":"string","enum":["BundlePricing"]},{"type":"string","enum":["ProductPricing"]},{"type":"string","enum":["SkuPricing"]}]},"budget_product_sku":{"type":"string","description":"A single product or SKU that will be covered in the budget"},"user":{"type":"string","description":"The username of the user for `user` scope budgets. This field is required when `budget_scope` is `user`."},"expires_at":{"type":"string","format":"date","description":"The date the budget will expire in `YYYY-MM-DD` format. Only dates in the future are accepted.\nIf not provided, the budget will not expire.\n\nOnly supported for budgets with `budget_scope` of `user`"}},"examples":[{"budget_amount":500,"prevent_further_usage":true,"budget_scope":"organization","budget_entity_name":"","budget_type":"ProductPricing","budget_product_sku":"actions","budget_alerting":{"will_alert":false,"alert_recipients":[]}}]}},"required":["path"],"additionalProperties":false},"name":"Create a budget for an organization","id":"github.billing.create-organization-budget","example":{"path":{"org":"example"}},"maxRequests":1,"summary":false}}