Locoia API Authentication - Personal Access Token
Authentication with our API of Locoia itself
There you can create new access tokens, update and regenerate existing ones with full flexibility.
The token itself is only visible right after creating a personal access token. In case you didn't save it, you can generate the token. The old token will then be invalidated.
We recommend to generate and manage personal access tokens directly in our app for, however, you can use our API for that as well.
In order to create a personal access token via API the following endpoint needs to be used:
post
https://api.locoia.com
/v1/personal-access-tokens
Create personal access token
The token itself is only visible right after creating a personal access token, after that it is impossible to retrieve it from the API.
One can regenerate a token with by sending the following
POST
request:post
https://api.locoia.com
/v1/personal-access-tokens/{{ token_id }}/regenerate
Regenerate personal access token
You can list all token with
get
https://api.locoia.com
/v1/personal-access-tokens
Get personal access tokens
The following scopes are available:
Scope Name | Entites |
---|---|
automation |
|
company |
|
connector_auth |
|
connectors |
|
dashboard |
|
embed |
|
There are different access levels based on the scope extension:
Scope Extension | Supported Scopes | Operations | Example |
---|---|---|---|
None (leave empty) | automation company connector_auth connectors dashboard embed | CRUD - Create, Read, Update, Delete | connector_auth - the token can create, read, update, and delete all Connector Auths to which the user who created the token has access to |
:manage | automation company connector_auth connectors dashboard embed | CRU - Create, Read, Update | connector_auth:manage - the user can do all of the above, except for deleting |
:view | automation company connector_auth connectors dashboard embed | R - Read | connector_auth:view - the user can only read the Connector Auths |
webhook_run | automation | Trigger Webhook Flows | automation - the token can trigger all Webhook Flows in the account (alternative to Flow specific webhook tokens) |
To authenticate with the token, simply specify it in the Authorization header like this:
Authorization: Bearer {{ token }}
or setup a Connector Auth for Locoia within the Locoia app and then use the token there.Last modified 1mo ago