This endpoint deals with authentication. It can be used to create a token that will grant access to the rest of the API, and to invalidate a token that is no longer desired.


To create a new auth token, send your auth details with a POST request:

http POST <<< '{ "email": "your_email", "password": "your_password" }'
curl --header "Content-Type: application/json" --request POST --data '{ "email": "your_email", "password": "your_password" }'

The values your_email and your_password are the e-mail and password for your account that is used to log into

On success, you will get a token with a response code of 201 (created):

        "token": "123456789abcdefghijklmnopqrstuvwxyzqwer"

This token can be used to authenticate subsequent requests as described in Authentication.


Do I need to generate a token each time I access the API?

A token only needs to be generated once per API user. It does not expire unless it is deleted manually.


To invalidate a token, make an authenticated DELETE request to /auth/.

http DELETE 'Authorization: Token 123456789abcdefghijklmnopqrstuvwxyzqwer'
curl --header "Content-Type: application/json" -H "Authorization: Token 123456789abcdefghijklmnopqrstuvwxyzqwer" --request DELETE

On success, you will get a response with code 204 (no content).