GuidesAPI ReferenceChangelog
Log In
Changelog
Back to All
deprecated

v2024-04-01 Deprecation

5 days ago by Gusto Developer Relations

With the release of v2025-06-15 , API version v2024-04-01 has now entered its deprecation period, effective June 15, 2025.

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

  • Full Support Phase (June 15, 2025 – December 15, 2025): During this initial 6-month phase, v2024-04-01 will continue to receive full maintenance, including bug fixes, security patches, and new feature support where applicable.
  • Limited Support Phase (December 16, 2025 – June 15, 2026): For the subsequent 6 months, v2024-04-01 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 June 15, 2026, API version v2024-04-01 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 v2025-06-15 ,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.