Team O'clock API is REST based and uses JSON for request and response payloads.


The base URL for the API is


https://www.teamoclock.com/api/v1/


Authentication


Authentication is performed using HTTP Basic Authentication, with the following credentials:

  • Username: Organization Slug
  • Password: Secret API key


You can find both under the Organization settings page (gear icon).


For example:


curl --user 'jenious-inc:skey-abcd' https://www.teamoclock.com/api/v1/teams

or in the browser

https://jenious-inc:skey-abcd@www.teamoclock.com/api/v1/teams 

Basic usage

The REST api supports the GET, POST, PUT and DELETE operations for getting, creating, updating and deleting resources.


The request and response payloads are in JSON format. For example:


curl --user 'jenious-inc:skey-abcd'
     -X POST
     -d '{"name": "My team", "slug": "my-team"}'
     -H "Content-Type: application/json"
     https://www.teamoclock.com/api/v1/teams