# API

Also you can check the status of the systems [here](https://status.caleida.io/)

## Accessing to more advanced documentation

You can access [here](https://api.caleida.io/) to all the API documentation.

## 1. Get an API Key

The first thing you need to do is to get an API Key. To do this go to **Advanced Integrations and** click on configuration in **API** in the Caleida Dasboard.

Once here give it a name and copy it or write it down in a safe place. You will not be able to see this key again in full from the Caleida website.

<figure><img src="/files/7H1HZ1hIUevCWBfAyWXo" alt=""><figcaption></figcaption></figure>

## 2. Access Postman

Through the following[ link](https://www.postman.com) you can access Postman. Create an account or login if you already have one.

Once inside click on send an API request.

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

## 3. Authorize your API

Under "Enter URL or paste text", click on "Authorization" and in the drop down menu select "API Key".

Now we will fill in the fields:

* **Key:** API Name (use the same one you gave in Caleida).
* **Value:** Paste the API Key you copied from the Caleida website.
* **Add to:** Make sure you add it to "Header".

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

## 4. Configure and send a request

Once the API is authorized, we will configure the request. Make sure it is a "GET" request and enter the link [https://core.api.caleida.io/chats/records/{chat\_id}/](https://core.api.caleida.io/chats/records/%7Bchat_id%7D/) (where {chat\_id} represents the ID of the chat you wish to access).

For example, if your chat ID is 12345, the URL would be <https://core.api.caleida.io/chats/records/12345/>

### 4.1 Get the Chat ID

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

Once you have pasted the URL click on "Send".


---

# 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.caleida.io/integrations/api.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.