WorkTrail Hub

The WorkTrail Hub allows you to easily integrate information and user data from third party application within WorkTrail. This is part of our Quantified Workplace idea. The whole point is to add as much user data into our timeline to give the user much more context about their work entries.

Hub Scope

Every app which writes into the WorkTrail Hub has it's own data scope. This means that it cannot access, overwrite or delete data from other apps which wrote their data into the Hub.

Creating Hub Entries

One Hub entry is one data point for your app. This can be for example one phone call, one commit in a source control system, one activity in a ERP, etc.

Request URL

POST to: https://worktrail.net/rest/hub/entries/create/

Request Object

{
  "employee_id": 123, # optional
  "time": 123, # timestamp in seconds since 1970
  "endtime": 150, # optional, timestamp in seconds
  "srctype": "issues", # the source of this hub entry, currently must be one of: issues, erp, scm, phone, geo, other
  "summary": "lorem ipsum", # summary of the activity
  "link": "http://...", # link relevant to this activity
  "privacy": "private", # optional, one of: "private", "company"
}

Cleaning all Hub Entries

If your app entered invalid data, or you want to run a clean sync from scratch you can delete all data your app has ever made for a given user.

Request URL

POST to: https://worktrail.net/rest/hub/entries/clean/