All functions available to Cogniti’s web-based frontend are driven by backend RESTful APIs. These are largely undocumented so you use them at your own risk.
Authentication #
All HTTP requests directly to the Cogniti API endpoints must contain an ‘Authorization’ header, whose value must be ‘Bearer <token>’ where <token> is an API token you generate for your own use.
Generating an API token #
IMPORTANT: Treat your API tokens as securely as you treat your passwords. Anyone with your API token(s) will be able to perform operations in Cogniti as you. We recommend you cycle your API tokens regularly.
Navigate to the Users page in Cogniti:
In your row in the Users table, click the pencil/edit icon.
In the API tokens section, you’ll find a list of your existing tokens.
To generate a new token, enter a description and expiry (in days). For example:
A new token will appear in the New token textbox below. Ensure you store this somewhere safe, as it will only be displayed this one time.
Deleting an API token #
Click the trash icon next to the API token(s) you wish to delete.
Calling the API endpoints #
These are currently undocumented. You may wish to inspect XHR/fetch requests in your browser’s developer console to find out more.