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.

List all bookmarks

Lists all bookmarks, sorted by name.

GET /time_entries/bookmarks.xml
GET /time_entries/bookmarks.json
Status: 200 OK
[
  {
    "bookmark": {...}
   },
   {
      "bookmark": {...}
   }
]
Status: 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<bookmarks type="array">
   <bookmark>
      ...
   </bookmark>
   <bookmark>
      ...
   </bookmark>
</bookmarks>

Get a single bookmark

Returns a single bookmark by its ID.

GET /time_entries/bookmarks/:id.xml
GET /time_entries/bookmarks/:id.json

Request

Status: 200 OK
{
   "bookmark": {
      "id": 79133,
      "name": "Project 'Website' current week",
      "query": "project_id=21243&amp;at=this_week",
      "type": "time_entries",
      "account_id": 1932,
      "user_id": 6546,
      "created_at": "2015-09-23T19:46:23+02:00",
      "updated_at": "2015-09-23T19:46:23+02:00"
   }
}
Status: 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<bookmark>
   <id type="integer">79133</id>
   <name>Project 'Website' current week</name>
   <query>project_id=212&amp;at=this_week</query>
   <type>time_entries</type>
   <account-id type="integer">1932</account-id>
   <user-id type="integer">6546</user-id>
   <created-at type="datetime">2015-09-23T19:46:23+02:00</created-at>
   <updated-at type="datetime">2015-09-23T19:46:23+02:00</updated-at>
</bookmark>

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

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

GET /time_entries.xml?project_id=21243&at=this_week
GET /time_entries.json?project_id=21243&at=this_week

Get all time entries of a bookmark

Or, you can call a single bookmark directly by its ID:

GET /time_entries/bookmarks/:id/follow.xml
GET /time_entries/bookmarks/:id/follow.json

Request

Status: 302
Location: https://demo.{{ site.webapp_domain }}/time_entries.json?project_id=212&at=this_week
{empty}
Status: 302
Location: https://demo.{{ site.webapp_domain }}/time_entries.xml?project_id=212&at=this_week
{empty}

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