> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rulebase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Gradient Labs

> Connect Gradient Labs to Rulebase with a management and an integration API key.

Gradient Labs assigns each API key exactly one role, so one key cannot do both jobs:

* **Management** — updates procedures, tools, resources, and other agent configuration.
* **Integration** — runs conversations, including test runs against your agent.

Submit both keys to use everything Rulebase can do with Gradient Labs. If you only have one, submit it now and add the other later — you keep the capabilities of the keys you have shared.

## Prerequisites

* You must be a Gradient Labs Admin.
* You must have the Administrator role or `integrations:manage` permission in Rulebase.

## Installation

### Step 1: Create a management API key in Gradient Labs (for agent configuration)

1. Sign in to Gradient Labs.
2. Go to **Integrations** > **API**.
3. In the **API Keys** section, click **New API key**.
4. Give the key a name, choose the **Management** role, and create the key.
5. Copy the key immediately. Gradient Labs shows it only once.

### Step 2: Create an integration API key in Gradient Labs (for conversations)

1. In **Integrations** > **API**, click **New API key** again.
2. Give the key a name, choose the **Integration** role, and create the key.
3. Copy the key immediately. Gradient Labs shows it only once.

Requests sent with the wrong role fail with `permission_denied`, so keep the two keys distinct. See [Gradient Labs API authentication](https://api-docs.gradient-labs.ai/pages/api-reference/authentication) for details about API-key roles and authentication.

### Step 3: Connect Gradient Labs in Rulebase

1. Log in to your [Rulebase dashboard](https://app.rulebase.co).
2. Go to **Settings** > **Connections**.
3. Find **Gradient Labs** and click **Add connection**.
4. Paste the **Management API key**, the **Integration API key**, or both.
5. Click **Connect**.

## Next steps

* To rotate or add a key, create it in Gradient Labs and submit it from **Settings** > **Connections**. A key you leave blank keeps its stored value.
* See [Roles and permissions](/guides/roles-and-permissions) to control which Rulebase users can manage connections.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.