How to create and invalidate API tokens.

Generating API Tokens

1920

Head over to API Tokens section, and click on "+", give it a name, choose permission level and press Add.

Tokens can have one of 2 permission levels:

  • Read - Allows you to perform reads against the API, but won't let you change anything.
  • Write - Full access token. Allows reads and writes.
1946

Invalidating API Tokens

Click the delete button next to the token name you wish to delete.

Using API Tokens

Supply your API token in the Authorization header, as a Bearer token in all authenticated API calls.

curl https://api.controld.com/users --header 'authorization: Bearer YOUR_FANCY_TOKEN'

You should see your account details if you've done this correctly.