Always make sure to use the correct domain and sub domains, vid|chat|api| becomes vid|chat|api|backoffice. if you are using a specific instance

Create a programmatic user

Each request to Algoreg APIs are done on the behalf of a programmatic user you first need to create.

  1. Login as an administrator to your instance of Algoreg, your instance of algoreg should be on this url format:
  2. Go to and click “New API Key”
  3. Choose an email to identify your new user and a name. For instance, ”” and “api-algoreg”. And click on Submit. You can note the autogenerated password or ignore it (you will be able to generate a new one later).
  4. In the list of users, click on the Edit icon (pencil icon).
  5. Affect the roles prefixed by “API_”, for instance if you want to integrate Go!Vid APIs, add “API_Agent_Vid_ARO”.
  6. Click on Submit.
At any time, you can reset the key or remove the programmatic user.

Obtain a Oauth token

We are now going to generate an access token from this programmatic user. This token will be used in any other requests made to Algoreg APIs.

The token is valid for 1 hour. You will need to generate a new one after this delay. If it is more convenient for you, you can generate a new token for each request.

Api calls must be sent to (or https://api.{instance} if your using a specific instance).

const api_key = "some_key";
const api_user = "";
const api_url = "";

async function getAccessToken() {
  const response = await fetch(api_url + "/api/v1/token", {
    method: "POST",
    body: JSON.stringify({
      grant_type: "password",
      username: api_user,
      password: api_key,
  return (await response.json()).access_token;

console.log(await getAccessToken());

If you try to login too many times with a wrong password, your programmatic account can be locked. In this case please contact the Algoreg support.

Use the token in your requests

Now that you have a token, you can use it in your requests. You can use it in the Authorization header of your requests:

Authorization: Bearer {access_token}

Congratulations 🎉

Now you can do everything in Algoreg without ever accessing our backoffice. It can be usefull to integrate Algoreg to your workflows and existing software.

Let’s jump to some of the most common APIs you will want to use with Algoreg:

Have a great journey with Algoreg 👋