Public preview
Adds support for running API operations in batches Public preview
What’s new
Adds the ability to create, process, and track large asynchronous batches of API operations using the new Batch Jobs v2 API.
Impact
You can now create batches of API calls to run asynchronously. That helps you handle large-scale operations efficiently and process bulk operations like creating multiple customers, migrating subscriptions, or updating large datasets.
The Batch Jobs API has built-in error handling and progress tracking through webhook events. For more detail about working with it and the resources it supports, see Batch jobs.
Changes
| Change | Resource | |
|---|---|---|
| Added | V2. Core. BatchJob | |
| Endpoints | Change | Resource |
| cancel create retrieve | Added | V2. Core. BatchJob |
| Change | Event type | |
| V2CoreBatchJobBatchFailedEvent V2CoreBatchJobCanceledEvent V2CoreBatchJobCompletedEvent V2CoreBatchJobCreatedEvent V2CoreBatchJobReadyForUploadEvent V2CoreBatchJobTimeoutEvent V2CoreBatchJobUpdatedEvent V2CoreBatchJobUploadTimeoutEvent V2CoreBatchJobValidatingEvent V2CoreBatchJobValidationFailedEvent | Added | V2.Core.BatchJob |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-03-25. preview
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.