release: 4.4.0 (#265) Automated Release PR --- ## 4.4.0 (2026-03-09) Full Changelog: [v4.3.0...v4.4.0](v4.3.0...v4.4.0) ### Features - Add archive_billing_configurations endpoint - Enable rollover fraction on credits ### Bug Fixes - fix request delays for retrying to be more respectful of high requested delays ### Docs - update documentation for /usage/groups ### Chores - **ci:** skip uploading artifacts on stainless-internal branches --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 4.3.0 (#264) Automated Release PR --- ## 4.3.0 (2026-03-03) Full Changelog: [v4.2.0...v4.3.0](v4.2.0...v4.3.0) ### Breaking Change * Remove minimum config field from Rate and Override schemas --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 4.2.0 (#260) Automated Release PR --- ## 4.2.0 (2026-03-02) Full Changelog: [v4.1.0...v4.2.0](v4.1.0...v4.2.0) ## Breaking Changes - **Removed `priority` parameter and response field from contracts** — the `priority` field is no longer accepted as an input or returned in contract responses. ## Features - **Minimum config support for percentage and tiered percentage overwrites** — you can now specify a `minimum_config` when defining percentage and tiered percentage overwrite rates. - **`minimum_config` added to rates and commits** — the `minimum_config` field is now available on rate and commit objects, along with specialized override tier types. - **`subscription_id` field on invoice line items** — invoice line item objects now include a `subscription_id` field. - **Compound group keys supported in `/v1/usage/groups`** — the usage groups endpoint now supports compound group keys for more granular usage aggregation. - **New package endpoints** — the SDK has been updated to include new package endpoints. ## Bug Fixes - **Request cancellation during retry wait** — fixed an issue where a request could not be canceled while it was waiting to retry. - **`NullStruct` serialization** — the encoder now correctly serializes `NullStruct` values. ## Docs - Added missing documentation descriptions across several API fields. --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 4.1.0 (#259) Automated Release PR --- ## 4.1.0 (2026-02-04) Full Changelog: [[v4.0.0...v4.1.0](v4.0.0...v4.1.0)] ### Features - Add `exclude` field to commit and override specifiers shape in the API - Support TieredPercentage rate on CommitRate - Expose add revenue config in edit contract api - Release account hierarchy - Add API to allow editing net payment terms - Add getNetBalance endpoint ### Bug Fixes - **docs:** fix mcp installation instructions for remote servers ### Chores - **ci:** upgrade `actions/github-script` ### Documentation - Update package docs for GA --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 4.0.0 (#258) Automated Release PR --- ## 4.0.0 (2026-01-17) Full Changelog: [v3.2.0...v4.0.0](v3.2.0...v4.0.0) ### ⚠ BREAKING CHANGES * Remove `use_list_prices` from Rate objects ([cface3](cface3c)) * Add `revenue_system_payments` to Payment object and `revenue_system_invoice` to Invoice object ([892c65](892c657)) ### Features * Add recurring commit ID and subscription config to Commit and Credit objects. ([1a719d](1a719da)) * Add support for custom fields on package terms ([6f9712](6f97122)) * **client:** add support for binary request streaming ([4fdf13d](4fdf13d)) ### Chores * **internal:** codegen related update ([5359acb](5359acb)) * **internal:** update `actions/checkout` version ([874dc0b](874dc0b)) ### Documentation * prominently feature MCP server setup in root SDK readmes ([0708fd1](0708fd1)) --- This pull request is managed by Stainless's [GitHub App](https://github.com/apps/stainless-app). The [semver version number](https://semver.org/#semantic-versioning-specification-semver) is based on included [commit messages](https://www.conventionalcommits.org/en/v1.0.0/). Alternatively, you can manually set the version number in the title of this pull request. For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request. 🔗 Stainless [website](https://www.stainlessapi.com) 📚 Read the [docs](https://app.stainlessapi.com/docs) 🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 3.2.0 (#256) ## 3.2.0 (2025-12-18) ### Features - feat: Update contract creation endpoints to allow setting revenue system configuration - feat: Add `commit_transactions` to the body of `/upsertAvalaraCredentials` endpoint - feat: Add `seat_filter` field to creation request and response parameters of the alert object - feat: Add `quantity` field to plan pricing adjustment response - feat: Add `external_payment_id` field to `ExternalInvoice` - feat: Add `description` field to `Credit` response - feat: Include `custom_sql` to `aggregation_type` in `UsageSearchResponse` - feat: Return object response for `SetBillingConfigurations` endpoint - feat: update create alert api to allow LowRemainingSeatBalanceReached alert ### Documentation - docs: Add gcp_marketplace enum - docs: Move contract edit v2 from beta to GA - docs: Document missing fields for schemas related to recurring credits and commits --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 3.1.0 (#255) Automated Release PR --- ## 3.1.0 (2025-10-31) Full Changelog: [v3.0.0...v3.1.0](v3.0.0...v3.1.0) ### Features * Add `payment_method_id` to `PaymentGateway.Stripe` * Add `billing_provider_error` to `invoice.external_invoice` * Add avalara creds + billing provider APIs. * Add `exclude_zero_balances` field to Contract list balances API. * Add `METRONOME` to `BillingProvider` type * (private beta) Add `low_remaining_seat_balance_reached` CustomerAlert type. * Add v2 notifications APIs ### Bug Fixes * **client:** close streams without requiring full consumption ([ed2abf0](ed2abf0)) ### Chores * bump `httpx-aiohttp` version to 0.1.9 ([6fc03bc](6fc03bc)) * **internal/tests:** avoid race condition with implicit client cleanup ([53f9064](53f9064)) --- This pull request is managed by Stainless's [GitHub App](https://github.com/apps/stainless-app). The [semver version number](https://semver.org/#semantic-versioning-specification-semver) is based on included [commit messages](https://www.conventionalcommits.org/en/v1.0.0/). Alternatively, you can manually set the version number in the title of this pull request. For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request. 🔗 Stainless [website](https://www.stainlessapi.com) 📚 Read the [docs](https://app.stainlessapi.com/docs) 🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 3.0.0 (#254) Automated Release PR --- ## 3.0.0 (2025-10-16) Full Changelog: [v2.0.0...v3.0.0](v2.0.0...v3.0.0) ### ⚠ BREAKING CHANGES * **api:** Remove `customer_id` from preview events request params --- This pull request is managed by Stainless's [GitHub App](https://github.com/apps/stainless-app). The [semver version number](https://semver.org/#semantic-versioning-specification-semver) is based on included [commit messages](https://www.conventionalcommits.org/en/v1.0.0/). Alternatively, you can manually set the version number in the title of this pull request. For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request. 🔗 Stainless [website](https://www.stainlessapi.com) 📚 Read the [docs](https://app.stainlessapi.com/docs) 🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 2.0.0 (#253) Automated Release PR --- ## 2.0.0 (2025-10-10) Full Changelog: [v1.0.0...v2.0.0](v1.0.0...v2.0.0) ### ⚠ BREAKING CHANGES * Update Preview Events API to return list of invoices ### Features * Add payment APIs and config * Add `billing_periods` to Subscription * Add `add_billing_provider_configuration_update` to the Contract edit API * Add `hierarchy_configuration` to the Commit and Credit edit APIs * Add `updated_at` to Customer object * Add `rate_type` to Recurring Commit and Recurring Credit ### Chores * **types:** change optional parameter type from NotGiven to Omit ([28b9d7e](28b9d7e)) --- This pull request is managed by Stainless's [GitHub App](https://github.com/apps/stainless-app). The [semver version number](https://semver.org/#semantic-versioning-specification-semver) is based on included [commit messages](https://www.conventionalcommits.org/en/v1.0.0/). Alternatively, you can manually set the version number in the title of this pull request. For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request. 🔗 Stainless [website](https://www.stainlessapi.com) 📚 Read the [docs](https://app.stainlessapi.com/docs) 🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

release: 1.0.0 (#252) Automated Release PR --- ## 1.0.0 (2025-09-15) Full Changelog: [v0.3.0...v1.0.0](v0.3.0...v1.0.0) ### ⚠ BREAKING CHANGES * **api:** add pagination support to multiple endpoints - Added pagination to CustomerList, AlertList, InvoiceList, CommitList, CreditList, CreditGrantList, CustomerAlerts, UsageList, CustomFields list, and ContractListBalances endpoints. * **api:** enhance subscriptions and commits/credits - Added Individual enum to SubscriptionConfig and rate_type enums to UpdateCredit/UpdateCommit. * **api:** add comprehensive shared types to SDK - Added 34 new shared types including BaseThresholdCommit, BaseUsageFilter, Commit, CommitHierarchyConfiguration, CommitRate, CommitSpecifier, CommitSpecifierInput, Contract, ContractV2, ContractWithoutAmendments, Credit, CreditTypeData, Discount, EventTypeFilter, HierarchyConfiguration, ID, Override, OverrideTier, OverwriteRate, PaymentGateConfig, PaymentGateConfigV2, PrepaidBalanceThresholdConfiguration, PrepaidBalanceThresholdConfigurationV2, PropertyFilter, ProService, Rate, RecurringCommitSubscriptionConfig, ScheduledCharge, ScheduleDuration, SchedulePointInTime, SpendThresholdConfiguration, SpendThresholdConfigurationV2, Subscription, Tier, and UpdateBaseThresholdCommit. ### Features * **api:** add archived_at field to CustomerBillingConfiguration ([7f5fbab](7f5fbab)) * **api:** add comprehensive shared types to SDK - Added 34 new shared types including BaseThresholdCommit, BaseUsageFilter, Commit, CommitHierarchyConfiguration, CommitRate, CommitSpecifier, CommitSpecifierInput, Contract, ContractV2, ContractWithoutAmendments, Credit, CreditTypeData, Discount, EventTypeFilter, HierarchyConfiguration, ID, Override, OverrideTier, OverwriteRate, PaymentGateConfig, PaymentGateConfigV2, PrepaidBalanceThresholdConfiguration, PrepaidBalanceThresholdConfigurationV2, PropertyFilter, ProService, Rate, RecurringCommitSubscriptionConfig, ScheduledCharge, ScheduleDuration, SchedulePointInTime, SpendThresholdConfiguration, SpendThresholdConfigurationV2, Subscription, Tier, and UpdateBaseThresholdCommit. ([7f5fbab](7f5fbab)) * **api:** add created_at field to Commit ([7f5fbab](7f5fbab)) * **api:** add customer billing configuration endpoints - Added set and retrieve endpoints for customer billing configurations. ([7f5fbab](7f5fbab)) * **api:** add pagination support to multiple endpoints - Added pagination to CustomerList, AlertList, InvoiceList, CommitList, CreditList, CreditGrantList, CustomerAlerts, UsageList, CustomFields list, and ContractListBalances endpoints. ([7f5fbab](7f5fbab)) * **api:** Add support for granular spend threshold alerts with group key filters. ([7f5fbab](7f5fbab)) * **api:** enhance subscriptions and commits/credits - Added Individual enum to SubscriptionConfig and rate_type enums to UpdateCredit/UpdateCommit. ([7f5fbab](7f5fbab)) ### Bug Fixes * avoid newer type syntax ([7f5fbab](7f5fbab)) ### Chores * revert changelog changes ([fb55732](fb55732)) * revert version bump ([89ff28c](89ff28c)) ### Documentation * enhance API documentation - Added more detailed descriptions and styling improvements, and enhanced usage filter documentation with additional context. ([7f5fbab](7f5fbab)) --- This pull request is managed by Stainless's [GitHub App](https://github.com/apps/stainless-app). The [semver version number](https://semver.org/#semantic-versioning-specification-semver) is based on included [commit messages](https://www.conventionalcommits.org/en/v1.0.0/). Alternatively, you can manually set the version number in the title of this pull request. For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request. 🔗 Stainless [website](https://www.stainlessapi.com) 📚 Read the [docs](https://app.stainlessapi.com/docs) 🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions --------- Co-authored-by: Samuel El-Borai <sam@elborai.me> Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>