GuidesAPI ReferenceChangelog
Log In
Changelog
Start typing to search…
Back to All
Deprecated

v2025-11-15 Deprecation

12 days ago by Gusto Developer Relations

With the release of v2026-02-01, API version v2025-11-15 has now entered its deprecation period, effective February 1, 2026.

The deprecation period spans 12 months and consists of two distinct phases:

  • Full Support Phase (February 1, 2026 – August 1, 2026): During this initial 6-month phase, v2025-11-15 will continue to receive full maintenance, including bug fixes, security patches, and new feature support where applicable.
  • Limited Support Phase (August 2, 2026 – February 1, 2027): For the subsequent 6 months, v2025-11-15 will remain functional but will not receive additional updates such as version-specific bug fixes. Critical security vulnerabilities or major defects will be addressed on a case-by-case basis during this phase.

After February 1, 2027, API version v2025-11-15 will be retired and become unusable. If your API request header specifies a version older than the oldest supported stable version, your API request will return a 406 Not Acceptable error. If no version is specified in the request header, your API request will default to the Minimum API Version listed in our Developer Portal.

Once you've completed your upgrade, have updated your headers to specify v2026-02-01 ,and are ready for your Minimum API Version to be updated accordingly, please fill out this form to specify a date and, optionally, time for the update.

For more comprehensive details on all API updates, including new version releases and version deprecation timelines, please visit our Version Upgrade Guide, and API Versioning Guide.