# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autentique.com.br/api/integration-basics/altair.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.