Authentication

The TrackMaven API uses token authentication. This means that all calls to the API will require a token to be passed in order to successfully return a result.

Finding your API token

Tokens are specific to an organization - all users with the relevant permissions in an organization may access the API token. The token can be found in the 'Account' section of the TrackMaven application, alongside email and password functionality.

Making an authenticated request

In order to authenticate a call to the TrackMaven API, simply add the token query parameter to your request.

Example:

$ curl https://trackmavens.com/api/v1/workspaces/?token=MY_API_TOKEN

Authentication failure

All API endpoints require the token parameter to be present. If the parameter is missing or the token is incorrect, the API will return a 403 Forbidden response with a JSON containing an error object. The error object will describe the exact nature of the authentication failure.