# Hatz integration

{% hint style="info" %}
If you’re new to integrations in Rewst, read through our introductory integration documentation [here](https://docs.rewst.help/documentation/integrations).
{% endhint %}

## What does the Hatz integration do?

Our HatzAI integration enables you to build, deploy, and manage secure AI agents and workflows across your organization. The integration provides OpenAI-compatible chat completions, App Builder workflows, and file management.

## Set up the Hatz integration

### Set up steps in Hatz

1. Log in to the [Hatz Admin Dashboard](https://admin.hatz.ai/login).
2. Navigate to the **Workspace** tab.
3. Click **API Keys**.
4. Enter the name `Rewst` into the field.
5. Click **Generate API Key**.

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

6. Copy the API key value and store it somewhere secure. You'll need this information for further steps in Rewst.

### Set up steps in Rewst

Follow the below steps to configure a new integration:

1. Navigate to **Marketplace > Integrations** in the left side menu of your Rewst platform.
2. Search for `Hatz` in the integrations page.
3. Click on the integration tile to launch the configuration setup page.\
   \
   ![](/files/yjT23GEWqg25C6vhPIH3)<br>
4. Enter the information copied from Hatz into the **API Key** field.
5. Click **Save Configuration**.
6. Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for[ organization mapping](https://docs.rewst.help/documentation/integrations#what-is-organization-mapping). Complete your mapping as desired.

{% hint style="success" %}
Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our [Canny feedback collector](https://rewst.canny.io/integrations).
{% endhint %}

## Actions and endpoints

{% hint style="info" %}
For more on how actions work in Rewst, check out our [introductory actions documentation here](https://docs.rewst.help/documentation/workflows/actions-in-rewst).
{% endhint %}

View Hatz AI's own API documentation [here](https://api-docs.hatz.ai/).

| Category         | Action                 | Description                                                                                                    |
| ---------------- | ---------------------- | -------------------------------------------------------------------------------------------------------------- |
| Apps             | Query App              | Executes a Hatz AI app with provided inputs and returns the result.                                            |
| Apps             | Get App                | Retrieves details for a specific app including its configuration, user inputs, and prompt sections.            |
| Apps             | List Apps              | Retrieves a list of all apps/workflows created in the Hatz AI App Builder                                      |
| Chat Completions | Create Chat Completion | Sends messages to an AI model and receives a response.                                                         |
| Files            | Upload File            | Uploads a file to Hatz AI for use in chat completions or apps. Returns a file UUID. Maximum file size is 30MB. |
| Files            | List Files             | Retrieves a list of all files uploaded to Hatz AI.                                                             |
| Generic Request  | Hatz AI API Request    | Generic action for making authenticated requests against the Hatz AI API.                                      |
| Models           | List Models            | Retrieves a list of all available AI models on the Hatz AI platform.                                           |


---

# 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.rewst.help/documentation/integrations/integration-guides/hatz-integration.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.
