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

# Hive Connector

<Badge icon="arrow-left" color="gray">[Back to Search AI connectors list](/ai-for-service/searchai/content-sources#supported-connectors)</Badge>

Hive is a project management and collaboration tool for organizing tasks, projects, and workflows. The Hive Connector integrates Hive Actions and Sub-Actions into Search AI, enabling search across your project data.

| Specification              | Details                 |
| -------------------------- | ----------------------- |
| Repository type            | Cloud                   |
| Supported content          | Actions and Sub-Actions |
| RACL support               | Yes                     |
| Content filtering          | Yes                     |
| Auto permission resolution | Yes                     |

## Prerequisites

* Hive account
* Hive API Key and Workspace ID

## Generate an API Key on Hive

1. Open **Edit Profile** in the Hive application.
2. Go to **API Info**.
3. Copy the **API Key** and **Workspace ID**.

## Configure the Hive Connector

1. Navigate to **Content > Connectors** in Search AI and select **Hive**.
2. On the **Auth** tab, enter the following details:

| Field            | Description                   |
| ---------------- | ----------------------------- |
| **Name**         | Unique name for the connector |
| **API Key**      | API Key from Hive             |
| **Workspace ID** | Workspace ID from Hive        |

3. Click **Connect**.

## Content Ingestion

The connector ingests Actions and Sub-Actions from selected projects within your workspace. Actions from sub-projects are not ingested unless those sub-projects are explicitly selected.

To configure content ingestion:

1. Go to the **Configuration** tab of the connector.
2. Select **Sync Specific Content** and click **Configure**.
3. Select the projects to ingest actions from.
4. To include both a project and its sub-projects, select all relevant projects in the hierarchy.
5. Click **Save**.
6. Click **Sync Now** to start ingestion immediately, or configure a scheduled sync.

View ingested content under the **Content** tab.

Each Action and Sub-Action is ingested as a separate document. The content field includes description, comments, status, priority, deadline, milestones, assignees, and checked date. Other details are stored as metadata.

## RACL Support

Search AI controls access to Hive content based on project membership and assigned roles. For each action, all users with roles of creator, follower, or assignee are added to the `sys_racl` field.

Search AI automatically resolves permission entities for Hive — no manual API mapping is required. Permission entities are determined by project type and sharing type:

| Project Type | Sharing Type | sys\_racl               |
| ------------ | ------------ | ----------------------- |
| Public       | Everyone     | Workspace ID            |
| Public       | Custom       | projectID, Workspace ID |
| Private      | Everyone     | Workspace ID            |
| Private      | Custom       | projectID               |
| Private      | Me           | projectID               |

<Note>Client mode is not supported via Search AI.</Note>
