> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/integration-basics/altair.md).

# Using Altair

The most important step to use Altair is to access this link: <https://altair.autentique.com.br> (We made a few small changes to the standard Altair client to make your life easier, like custom collections with the main actions of Autentique).

### Request Headers

When you open the [link](https://altair.autentique.com.br/), the first screen you will see is the Headers screen.

<figure><img src="/files/Axna9PG6qtcdzNtjfF2t" alt=""><figcaption></figcaption></figure>

As you might have already guessed, these are the headers you need to include when making a request to the API, and the `YOUR_API_KEY_HERE` should be replaced with your actual [API key ](https://painel.autentique.com.br/perfil/api)(yes, this has happened before).

{% hint style="info" %}
Do not remove the "Bearer" part in front of the API key, just replace what comes after it.
{% endhint %}

If you want to change your key, you can access this screen again under ***Set Headers***.

![](/files/-LscgFjFwbQAq3vsku4U)

### Development Environments

The development environments contain variables with different values depending on the active environment:

![](/files/-LzJ4QUKeKOGYS16ABJd)

There are two interesting things in this image. The first is the `{{endpointURL}}`, which is the variable defined by the second interesting thing: the development environment, "Production," in the top right corner.

In the same menu, there's the "*Environments..."* option, which contains the definition of these variables:

![](/files/-LzJ5Ks8I1z5xJmpOt2c)

### Collections

We created some collections with the main actions/queries used in Autentique.\
You can check, test, or use them in your project — or use them as a reference to create your own queries.

<figure><img src="/files/R0M7kycXIS7csHH7NQp0" alt=""><figcaption></figcaption></figure>

The collections are just examples, so they don’t represent everything you can do with the API. Some require you to fill in parameters like document IDs, folder IDs, etc., to work properly.

{% hint style="warning" %}
*Collections* might not work on Firefox when using private mode.
{% endhint %}

### Documentation

Besides the collections, there's a more complete built-in documentation that shows everything you can do with the API.

Click **Docs** at the top of the screen to open the sidebar with the documentation.\
If it appears empty, click **Reload Docs** to refresh it. Still not working? Check the **Headers** tab to make sure you’ve added your API key, then try again.

![](/files/-LscgRAenAmKYK6zhrIe)

The first items are **Query** (functions that only fetch information) and **Mutation** (functions that perform actions or make changes). When you click on one of them, you’ll see what the API can currently do — including all available functions and the data you can query.

Next, we’ll show some of these queries/mutations and how to run them in **Altair**.

{% hint style="info" %}
Yes, the name Altair is a reference to Assassin’s Creed — that **might** have influenced our choice.
{% endhint %}

{% hint style="info" %}
If Altair doesn’t help you integrate with the API, check out other ways to make these requests: <https://graphql.org/graphql-js/graphql-clients/>
{% endhint %}

{% file src="/files/-M03o9cE5QB3vLoPUlzJ" %}
To import and use on Postman
{% endfile %}