Inscribe authenticates your API requests using secret tokens which can be created by administrators. Inscribe's API requires a valid secret token to be included in the header of all requests.

# Each cURL request requires the header to contain the authorization key as below.
  -H "Authorization: Inscribe <secret_token>"

Your existing API tokens are viewable through the Settings page when logged into the Inscribe web app. You must generate your first secret token using the 'Generate API Key' button. This will show you your secret key, please save this somewhere safe as you won't be able to see it again. You can create as many secret tokens as you need.


Deprecated Format

Prior to September 2021, API Keys generated by our API would have been given to you differently. We returned an access key, and a secret key, and we required you to base-64 encode these as follows: <access_key>:<secret_key>. We now return just one token which is already base-64 encoded. Previously generated API keys will continue to work when you base64 encode them yourself.