We are announcing the deprecation of Toggl Track's API v8. Calls to previous /api/v8/* endpoints, documented in the now archived toggl_api_docs repository, will cease to work in about six months. They should be replaced by their /api/v9/* counterparts documented in the Docs section of this site.

More information about the Toggl Track API v9 release can be found in the announcement on Toggl Track's blog and v8 migration guide.

Brownouts​

During brownout periods, endpoints will be temporarily disabled and then re-enabled after a few hours. The goal is to help API clients to notice the scheduled unavailability and plan their migration accordingly.

Brownouts period target is March 2023.

Removal​

The deprecated /api/v8/* endpoints will be disabled starting on April 1 2023.

This blog-like Changes part of the documentation is where all the relevant changes made to the Toggl Track API will be published. Backwards-incompatible changes and deprecation notices will be informed in advance, allowing API clients to plan their migration accordingly.

The best way to track them is to follow one of the feeds:

• Toggl Track API Changes Atom Feed
• Toggl Track API Changes RSS Feed

Questions about the documentation or published changes can be asked, as usual, on the regular support channels.