Toggl Blog

Better Faster Stronger – The New Toggl API

Six months ago we wrote about moving to the Go programming language and replacing our Ruby on Rails backend. Step-by-step we have done that and now most of the ajax requests inside Toggl (especially  m.toggl and Toggl Desktop) use our new Go API  (Toggl API v8), which sits in it’s very own server separate from the clunky RoR application. Today we are ready to make the API public.

 The Documentation

Our previous documentation was publicized on our own public web page and reporting bugs, asking questions, resolving issues went through our Support system with all the other problems regular users had. We wanted to make life a bit easier to our fellow developers and lo and behold! moved our documentation to Github - https://github.com/toggl/toggl_api_docs. We actually got this idea from Basecamp (no shame in admitting that), which published its Basecamp Next API documentation on Github.

Best things about having our documentation on Github:

  • Issues – if you have a questions or problems you can create an issue at Github, watch its progress and get direct feedback from the API developers.
  • Pull requests – if you find a bug in the documentation you can fork the repository, fix the bug and make a pull request. This way you don’t have to spend time reporting a bug, waiting for an answer and then the fix. We have tremendous respect for people who step up and take action!  You can read more about pull requests from here
  • You can follow our repository and see all the updates in your Github feed
  • Public commit history – you can see what functionality documentation was added and when. Pretty much reflects the API’s functionality implementation.

Help us towards a better API

So far we have implemented only those requests that are necessary for us. Which means some of the functionalities we had in API v6 may be missing. As we are actively implementing new API calls, we want to know what kind of functionalities you miss or would like to see. We anxiously await for our first Github issues.

Deprecating API v6

The arrival of the new API also means we are planning to remove the older public API v6. It will be removed September 1st 2013, so everyone using it should have enough time to update their applications and move over to the new API v8.

Janika Liiv

DEVELOPER
Janika claims to be the only female programmer in the entire Toggl. She’s also a playwright and a fan of violent, David Lynch-style stuff. Oh, and she’s also a belly dancer. You can follow her at @janikaliiv
  • Show 13 Comments

    1. Really?
      March 9, 2013 | Permalink

      Congratulations!

      I cannot download and install Toggl app on my Mac anymore. I cannot document my time anymore. Because I relied on your services I am loosing money now.

      Your have utterly failed to communicate to your clients what you’re doing. Firstly, you totally screwed up GUI (on desktop app) by making all your fields large (hello! we are in 10-11″ monitor size laptop….), secondly you don’t even make the application available for download and install. Thirdly, you don’t communicate to your clients. Fourthly, your blog is disorganized and littered with irrelevant information that makes it more (and not less) difficult to use your app, which, oh yes, you don’t have anymore.

      And you still want me to pay $5/month? Seriously? I’m severing all financial payments to you this moment.

      For such a “bright” team of people, …very disappointing. And people are surprised that unemployment is so high?

      Yes, I know you will delete this comment from your website. No, I did not give you my real email address.

    2. Nothing
      March 9, 2013 | Permalink

      Ouch!

    3. Stefan Huska
      March 9, 2013 | Permalink

      Good work guys!

      I think API is the future of next generation services :)

      And, if something works, and you guys, can spend time do it even better (interal logic / source code improvements), you deserve HUGE admiration.

    4. March 9, 2013 | Permalink

      @Really, sorry that you feel isolated from our communications! I’ll answer your questions one by one:

      * New Toggl Desktop has a dynamic user interface size. Just resize the window to be smaller, and all fonts and edit boxes will be also resized to accommodate your smaller screen

      * Toggl Desktop is available on our Tour page – https://www.toggl.com/public/tour#desktop. There is also an article on our Knowledge Base – http://support.toggl.com/customer/portal/articles/552102-toggl-on-my-desktop

      * We have tried to be as open with our communication as possible. You can use the following channels for up-to-date information about Toggl:
      1) Toggl Blog (http://blog.toggl.com)
      2) Knowledge Base (http://support.toggl.com)
      3) We respond to every e-mail sent to support@toggl.com
      4) Twitter feed – https://twitter.com/toggl
      5) Toggl Facebook page – http://www.facebook.com/Toggl
      6) We also send out e-mails to users to whom our updates are relevant

      All abovementioned channels are constantly monitored and updated. I agree that we can always do better, so any constructive feedback is highly appreciated!

      * I agree that blogs in essence are a bit unstructured. For structured information about Toggl please use our Knowledge Base – http://support.toggl.com

      * Yes, Toggl has a price of $5 per team member per month. We have a very liberal subscription policy, so you can cancel your account anytime without any excess costs or obligations.

      * Toggl helps fight unemployment by helping a lot of freelancers doing their daily jobs more efficiently.

      * We do not delete comments from our blog, with the only exception of spam messages.

    5. LS
      March 11, 2013 | Permalink

      Cool. Will be interested to check out the new API. Part of the reason I chose Toggl was because it had an API. We made some basic internal tools for better reporting, and found the API very useful, but could be improved. Looks like it has! Thanks!

    6. J
      March 11, 2013 | Permalink

      Great to see the new API, well done guys. I would love to see the addition of retrieving time entries by workspace with the ability to filter by client, project and task. We have some tools we have built internally where we currently have to query each user to collate data which means quite a few API requests. I would love to reduce those requests which would benefit both of us, speed up our apps and reduce the load on your API. Thanks guys.

    7. Markus
      March 11, 2013 | Permalink

      @guy-who-wrote-that-weird-rant Half of what you say is wrong, the other half is the wrong tone. The fact that you stay anonymous doesn’t make your post very credible, you know? 5$ is nothing for the service Toggl provides and what the heck does the whole thing have to do with unemployment?

    8. Hugh
      March 11, 2013 | Permalink

      Thanks Toggl folks. It gives me confidence in my choice of time trackers that you are continuing to invest time in your publicly documented API.

      I don’t use the API, but knowing it’s there if I need it is reassuring.

    9. Sujan Shakya
      March 11, 2013 | Permalink

      Love the way Toggl has improved its quality in UX and in performance in last few months.

    10. Asfihani
      March 13, 2013 | Permalink

      Congratulations! I love Toggl especially how the program is running very good in Linux. Only the invoice feature is missing. Yes, I know I can use 3rd party which cost another bucks :)

    11. March 14, 2013 | Permalink

      We just posted an article in TeamWeek blog about how we created TeamWeek’s API in Ruby on Rails. Check this out – http://blog.teamweek.com/2013/03/creating-rails-api-in-5-easy-steps/

    12. April 20, 2013 | Permalink

      This is fantastic, guys! I’ve otherwise been in love with Toggl since the first time I used it, but for the past few months had been thinking about making my own time tracking solution because I was in desperate need for a time tracker that allowed me to give read-only access to my clients. Now I can just make a simple page that hooks into your API and I’m all set.

      Thanks for saving me hundreds of hours! You have no idea how happy I am right now.

    13. April 29, 2013 | Permalink

      You may wish to correct a couple links/pages to the API documentation to make the transition to v8 a bit more clear…

      On the integration page (https://www.toggl.com/workspace/integration) the “Use Toggl’s API” link points to the v6 documentation (https://www.toggl.com/public/api).

      On that page (https://www.toggl.com/public/api), the API link at the footer points to the v8 documentation (https://www.toggl.com/public/api) — which is a bit confusing since one would be looking at the v6 documentation when they click that link.

      If I hadn’t looked at the blog, I would have assumed v6 is still the current api.

    One Trackback

  • Free time recording software with timesheet export.
    Check out Toggl