Login Deutsch

Developers welcome! The mite.api is looking forward to your precious hacking. Have a look at the detailed documentation to kick-start your coding.

Please note

Bookmarks can only be read, not created or edited over the mite.api. Team bookmarks are not visible to time trackers, they can only see there own bookmarks. All other roles can access their own as well as all team bookmarks, but not private bookmarks of other users.

Show all bookmarks

GET /time_entries/bookmarks.xml

Lists all bookmarks, sorted by name.

Response : 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<bookmarks type="array">
   <bookmark>
      ...
   </bookmark>
   <bookmark>
      ...
   </bookmark>
</bookmarks>

Show a single bookmark

GET /time_entries/bookmarks/{id}.xml

Returns a single bookmark.

Response : 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<bookmark>
  <account-id type="integer">1</account-id>
  <created-at type="datetime">2010-01-11T12:00:00+01:00</created-at>
  <id type="integer">1</id>
  <name>'Website conception' this week</name>
  <updated-at type="datetime">2010-01-11T12:00:00+01:00</updated-at>
  <user-id type="integer">1</user-id>
  <query>project_id=2&amp;at=this_week</query>
  <type>time_entries</type>
</bookmark>

Team bookmarks differ from user specific ones by the user_id-attribute set to nil.

The query attribute contains the actual data of the bookmark. To use it, simply add them as GET parameters to your next request:

GET /time_entries.xml?project_id=2&amp;at=this_week

Or, you can call a single bookmark directly by id:

GET /time_entries/bookmarks/{id}/follow.xml
Response : 302

This will redirect your client to '/time_entries.xml?{query}', returning all matching time entries.