REST API: List Last Modified Timestamps

Last Updated: May 16, 2017

Description

Retrieves a list of last_modified timestamps associated with each requested API endpoint. This is especially useful because you can see, with just one request, what endpoints may need to be queried to get changes since the last time you connected to the API.

Resource Information

HTTP Method GET
Endpoint https://rest.tsheets.com/api/v1/last_modified_timestamps
Authentication Token header required. See authentication section
Request format Everything is handled through the request uri on a GET.
Response format json
Response object Last Modified Timestamps

Available Filters

endpoints:
optional
String. Comma separated list of one or more endpoints. You can specify any endpoint - see each respective endpoint for the endpoint 'name' that you can use in this list. E.g. if you wanted to only check for changed timesheets and jobcodes, you'd specify 'timesheets,timesheets_deleted,jobcodes' as the value of this filter.

If you don't specify a list of endpoints, then the following list of endpoints is returned by default.
The default list of endpoints returned (if no 'endpoints' filter is specified) are:
current_user
customfields
customfielditems
effective_settings
geolocations
jobcodes
jobcode_assignments
timesheets
timesheets_deleted
users
reminders

Examples

Retrieve the default list of last modified timestamps.

## REQUEST
    curl -H "Authorization: Bearer <Access-Token>" -i "https://rest.tsheets.com/api/v1/last_modified_timestamps"

## RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json

{
 "results": {
  "last_modified_timestamps": {
   "current_user": "2014-11-04T18:42:52+00:00",
   "customfields": "2014-04-16T15:15:50+00:00",
   "customfielditems": "2014-12-04T20:29:03+00:00",
   "effective_settings": "2014-11-29T14:24:24+00:00",
   "geolocations": "2014-12-05T00:04:57+00:00",
   "jobcodes": "2014-12-04T20:29:01+00:00",
   "jobcode_assignments": "2014-12-04T20:29:02+00:00",
   "timesheets": "2014-12-05T00:05:00+00:00",
   "timesheets_deleted": "2014-10-22T21:46:25+00:00",
   "users": "2014-11-19T19:36:26+00:00",
   "reminders": "2014-12-04T20:29:03+00:00"
  }
 }
}

    

Retrieve the last modified timestamps for 'timesheets' and 'groups'.

## REQUEST
    curl -H "Authorization: Bearer <Access-Token>" -i "https://rest.tsheets.com/api/v1/last_modified_timestamps?endpoints=timesheets,groups"

## RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json

{
 "results": {
  "last_modified_timestamps": {
   "timesheets": "2014-12-05T00:05:00+00:00",
   "groups": "2014-12-05T00:04:57+00:00"
  }
 }
}