Agent skill · stripe
upgrade-stripe
Guide for upgrading Stripe API versions and SDKs
What it needs
About 3k tokens when loaded.
What this skill does
The latest Stripe API version is 2026-08-26.dahlia - use this version when upgrading unless the user specifies a different target version. Upgrading Stripe Versions This guide covers upgrading Stripe API versions, server-side SDKs, Stripe.js, and mobile SDKs. Understanding Stripe API Versioning Stripe uses date-based API versions (e.g., 2026-08-26.dahlia, 2025-08-27.basil, 2024-12-18.acacia). Your account’s API version determines request/response behavior. Types of Changes Backward-Compatible Changes (don’t require code updates): New API resources New optional request parameters New properties in existing responses Changes to opaque string lengths (e.g., object IDs) New webhook event types Breaking Changes (require code updates): Field renames or removals Behavioral modifications Removed endpoints or parameters Review the API Changelog for all changes between versions. Server-Side SDK Versioning See SDK Version Management for details. Dynamically-Typed Languages (Ruby, Python, PHP, Node.js) These SDKs offer flexible version control: Global Configuration: Per-Request Override: Strongly-Typed Languages (Java, Go, .NET) These use a fixed API version matching the SDK release date. Don’t set a different API version for strongly-typed languages because response objects might not match the strong types in the SDK. Instead, update the SDK to target a new API version. Best Practice Always specify the API version you’re integrating against in your code instead of relying on your account’s default API version: Stripe.js Versioning See Stripe.js Versioning for details. Stripe.js uses an evergreen model with major releases (Acacia, Basil, Clover, Dahlia) on a biannual basis. Loading Versioned Stripe.js Via Script Tag: Via npm: Major npm versions correspond to specific Stripe.js versions. API Version Pairing Each Stripe.js version automatically pairs with its corresponding API version. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills stripe/upgrade-stripe--bb36ad