Locoia API Authentication - Personal Access Token
Authentication with our API of Locoia itself

Creating a Personal Access Token

In order to create a personal access token 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.
You can also create it directly in Locoia with this Community Library Flow.
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

Scopes

The following scopes are available:
Scope Name
Entites
automation
  • Flows
  • Flow Runs
  • Flow Run Steps
  • Run Flows
  • Connector Auths (Read only)
  • Env Variables (Read only)
  • File Uploads (Read only)
company
  • Env Variables
  • File Uploads
  • Teams
  • Users
connector_auth
  • Connector Auths
connectors
  • Connectors
  • Connector Actions
dashboard
  • Dashboards
  • Data Sources
  • Forecasts
  • Insights
  • Transforms
embed
  • Embeds
All scopes have the following access levels:
Scope Extension
Operations
Example
None (leave empty)
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
CRU - Create, Read, Update
connector_auth:manage - the user can do all of the above, except for deleting
:view
R - Read
connector_auth:view - the user can only read the Connector Auths

Using Personal Access Token

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.
Copy link
On this page
Creating a Personal Access Token
post
Create personal access token
post
Regenerate personal access token
get
Get personal access tokens
Scopes
Using Personal Access Token