{"slug":"toggl-track-api","name":"Toggl Track API","host":"api.track.toggl.com","site":"https://toggl.com","category":"productivity","docsUrl":null,"sources":[{"kind":"changelog","url":"https://engineering.toggl.com/changes/"},{"kind":"archive","url":"https://engineering.toggl.com/changes/2022/10/01/api-v8-deprecation/"},{"kind":"archive","url":"https://engineering.toggl.com/changes/2023/11/02/v9-auth-endpoints-deprecation/"},{"kind":"archive","url":"https://engineering.toggl.com/changes/2024/06/12/v9-lost-password-endpoint-deprecation/"},{"kind":"archive","url":"https://engineering.toggl.com/changes/2024/08/09/deprecating_user_labour_costs/"}],"url":"https://www.okapi.bot/providers/toggl-track-api/","json":"https://www.okapi.bot/api/v1/providers/toggl-track-api.json","breakingChanges":[{"slug":"the-labour-cost-parameter-stops-working","api":"toggl-track-api","title":"The labour_cost parameter stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-08-09","effectiveAt":"2024-08-31","scope":null,"calls":["/api/v9/workspaces/*","body parameter labour_cost"],"method":null,"path":"/api/v9/workspaces/*","source":{"url":"https://engineering.toggl.com/changes/2024/08/09/deprecating_user_labour_costs/","kind":"archive"},"quote":"By 2024/08/31 , we will deprecate the old labour_cost property. After this date, you won't be able to change labor costs using the cents-based method.","migration":"Send labor_cost in monetary units (10.5 for $10.50) instead of labour_cost in cents on workspace user and project user updates.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:28.104Z","updatedAt":"2026-10-23T10:09:28.104Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/the-labour-cost-parameter-stops-working/"},{"slug":"the-workspace-user-lost-password-endpoint-stops-working","api":"toggl-track-api","title":"The workspace user lost password endpoint stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2024-06-12","scope":null,"calls":["/api/v9/workspaces/{}/users/{}/lost_password"],"method":null,"path":"/api/v9/workspaces/{}/users/{}/lost_password","source":{"url":"https://engineering.toggl.com/changes/2024/06/12/v9-lost-password-endpoint-deprecation/","kind":"archive"},"quote":"In this update, we are removing the following Track v9 endpoint: - /workspaces/{workspace_id}/users/{user_id}/lost_password There will be no brownout periods for this endpoint","migration":"Password resets go through Toggl's common accounts service (see the Authentication section of engineering.toggl.com/docs).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:25.697Z","updatedAt":"2026-10-23T10:09:25.697Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/the-workspace-user-lost-password-endpoint-stops-working/"},{"slug":"delete-api-v9-me-sessions-stops-working","api":"toggl-track-api","title":"DELETE /api/v9/me/sessions stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-11-02","effectiveAt":"2024-04-08","scope":null,"calls":["DELETE /api/v9/me/sessions"],"method":"DELETE","path":"/api/v9/me/sessions","source":{"url":"https://engineering.toggl.com/changes/2023/11/02/v9-auth-endpoints-deprecation/","kind":"archive"},"quote":"On 2024/04/08 the official support for the deprecated endpoints will cease and they will be removed without further notice.","migration":"Authenticate each request with the API token or basic auth (no session endpoints); sign-up, account closing and password resets go through Toggl's common accounts service described in the Authentication section of engineering.toggl.com/docs.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:15.919Z","updatedAt":"2026-10-23T10:09:15.919Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/delete-api-v9-me-sessions-stops-working/"},{"slug":"post-api-v9-me-close-account-stops-working","api":"toggl-track-api","title":"POST /api/v9/me/close_account stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-11-02","effectiveAt":"2024-04-08","scope":null,"calls":["POST /api/v9/me/close_account"],"method":"POST","path":"/api/v9/me/close_account","source":{"url":"https://engineering.toggl.com/changes/2023/11/02/v9-auth-endpoints-deprecation/","kind":"archive"},"quote":"On 2024/04/08 the official support for the deprecated endpoints will cease and they will be removed without further notice.","migration":"Authenticate each request with the API token or basic auth (no session endpoints); sign-up, account closing and password resets go through Toggl's common accounts service described in the Authentication section of engineering.toggl.com/docs.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:15.919Z","updatedAt":"2026-10-23T10:09:15.919Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/post-api-v9-me-close-account-stops-working/"},{"slug":"post-api-v9-me-lost-passwords-stops-working","api":"toggl-track-api","title":"POST /api/v9/me/lost_passwords stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-11-02","effectiveAt":"2024-04-08","scope":null,"calls":["POST /api/v9/me/lost_passwords"],"method":"POST","path":"/api/v9/me/lost_passwords","source":{"url":"https://engineering.toggl.com/changes/2023/11/02/v9-auth-endpoints-deprecation/","kind":"archive"},"quote":"On 2024/04/08 the official support for the deprecated endpoints will cease and they will be removed without further notice.","migration":"Authenticate each request with the API token or basic auth (no session endpoints); sign-up, account closing and password resets go through Toggl's common accounts service described in the Authentication section of engineering.toggl.com/docs.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:15.919Z","updatedAt":"2026-10-23T10:09:15.919Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/post-api-v9-me-lost-passwords-stops-working/"},{"slug":"post-api-v9-me-sessions-stops-working","api":"toggl-track-api","title":"POST /api/v9/me/sessions stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-11-02","effectiveAt":"2024-04-08","scope":null,"calls":["POST /api/v9/me/sessions"],"method":"POST","path":"/api/v9/me/sessions","source":{"url":"https://engineering.toggl.com/changes/2023/11/02/v9-auth-endpoints-deprecation/","kind":"archive"},"quote":"On 2024/04/08 the official support for the deprecated endpoints will cease and they will be removed without further notice.","migration":"Authenticate each request with the API token or basic auth (no session endpoints); sign-up, account closing and password resets go through Toggl's common accounts service described in the Authentication section of engineering.toggl.com/docs.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:15.919Z","updatedAt":"2026-10-23T10:09:15.919Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/post-api-v9-me-sessions-stops-working/"},{"slug":"post-api-v9-signup-stops-working","api":"toggl-track-api","title":"POST /api/v9/signup stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-11-02","effectiveAt":"2024-04-08","scope":null,"calls":["POST /api/v9/signup"],"method":"POST","path":"/api/v9/signup","source":{"url":"https://engineering.toggl.com/changes/2023/11/02/v9-auth-endpoints-deprecation/","kind":"archive"},"quote":"On 2024/04/08 the official support for the deprecated endpoints will cease and they will be removed without further notice.","migration":"Authenticate each request with the API token or basic auth (no session endpoints); sign-up, account closing and password resets go through Toggl's common accounts service described in the Authentication section of engineering.toggl.com/docs.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:15.919Z","updatedAt":"2026-10-23T10:09:15.919Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/post-api-v9-signup-stops-working/"},{"slug":"the-track-api-v8-stops-working","api":"toggl-track-api","title":"The Track API v8 stops working","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":"2022-10-01","effectiveAt":"2023-04-01","scope":null,"calls":["/api/v8/*"],"method":null,"path":"/api/v8/*","source":{"url":"https://engineering.toggl.com/changes/2022/10/01/api-v8-deprecation/","kind":"archive"},"quote":"The deprecated /api/v8/* endpoints will be disabled starting on April 1 2023.","migration":"Call the /api/v9/* counterparts (https://api.track.toggl.com/api/v9/...), following Toggl's v8 migration guide.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:09:14.055Z","updatedAt":"2026-10-23T10:09:14.055Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/toggl-track-api/breaking-changes/the-track-api-v8-stops-working/"}]}