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

# Hive

> How to set up the Hive connector, plus the actions and events that are available.

![Hive](https://stackone-logos.com/api/hive/filled/svg)

v2.2.1[See changelog](https://docs.stackone.com/connectors/hive/changelog.md)

[29 actions](#actions) · [7 events](#events) · 1 auth method

Project Management
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/hive/guides/connector-profile/api-key.md)
>
> No app registration required. Hive issues a personal API key to each user, and it inherits that user's own workspace per...

Optionally, configure receiving Events for Hive into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/hive/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/hive/guides/link-account/api-key.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

29 actions

ActionDescription

List Actions`hive_list_actions`

Retrieve all actions (tasks) within a specific workspace.

Search Actions`hive_search_actions`

Find actions (tasks) in a workspace by title.

Get Action`hive_get_action`

Retrieve a specific action (task) by its ID.

Create Action`hive_create_action`

Create a new action (task) in Hive.

Update Action`hive_update_action`

Update an existing action's properties.

Delete Action`hive_delete_action`

Delete an action (task) by its ID.

List Action Comments`hive_list_action_comments`

Retrieve all comments on a specific Hive action (task).

Create Action Comment`hive_create_action_comment`

Add a new comment to a specific action.

Get Unified Credentials`hive_unified_get_me`

Return the authenticated identity and auth type for the current Hive connection. Hive has no /me endpoint; this action u...

List Unified Groups`hive_unified_list_groups`

List Hive workspaces as IAM groups. Hive workspaces are the natural unit of grouping (containers for projects, actions,...

Get Unified Group`hive_unified_get_group`

Retrieve a single Hive workspace by id, mapped to the IAM unified group schema, optionally expanding members.

List Unified Organizations`hive_unified_list_organizations`

List the synthesized Hive organization. Hive has no /accounts or /tenants endpoint; this action returns a single synthet...

Get Unified Organization`hive_unified_get_organization`

Retrieve the synthesized Hive organization. Hive has no /accounts or /tenants endpoint, so this action returns the singl...

List Unified Roles`hive_unified_list_roles`

Return Hive's five documented workspace roles (External User, Member, Admin, System Admin, Restricted User). Hive's role...

Get Unified Role`hive_unified_get_role`

Retrieve one of Hive's five documented workspace roles (External User, Member, Admin, System Admin, Restricted User) by...

List Unified Users`hive_unified_list_users`

List Hive workspace members mapped to the IAM unified user schema. When filter.group\_id is provided, returns members of...

Get Unified User`hive_unified_get_user`

Retrieve a single Hive user by id, mapped to the IAM unified user schema. Returns 404 when no user matches the id. roles...

List Labels`hive_list_labels`

Retrieve all labels within a specific workspace.

Get Label`hive_get_label`

Retrieve a specific label within a workspace.

Create Label`hive_create_label`

Create a new label in a Hive workspace.

Update Label`hive_update_label`

Update an existing label's properties in a workspace.

Delete Label`hive_delete_label`

Delete a label from a workspace.

List Projects`hive_list_projects`

Retrieve all projects within a specific workspace.

Get Project`hive_get_project`

Retrieve a specific project by its ID.

Create Project`hive_create_project`

Create a new project in Hive.

Update Project`hive_update_project`

Update an existing project's properties.

Delete Project`hive_delete_project`

Delete a project by its ID.

List Workspaces`hive_list_workspaces`

Retrieve all workspaces accessible to the authenticated user.

List Workspace Users`hive_list_workspace_users`

Retrieve all users belonging to a specific workspace.

## Events

Tags

Select all
|
Clear

Actions

Forms

Messages

Projects

Webhooks

No tags found

7 events

EventDescriptionTags

Action Created Webhook`hive_webhook_action_created`

Processes Hive actions::i events, fired when an action (task) is created in the workspace.

ActionsWebhooks

Action Updated Webhook`hive_webhook_action_updated`

Processes Hive actions::u events, fired when any field of an action (task) in the workspace is updated.

ActionsWebhooks

Project Created Webhook`hive_webhook_project_created`

Processes Hive projects::i events, fired when a project is created in the workspace.

ProjectsWebhooks

Project Updated Webhook`hive_webhook_project_updated`

Processes Hive projects::u events, fired when any field of a project in the workspace is updated.

ProjectsWebhooks

Form Submission Created Webhook`hive_webhook_form_submission_created`

Processes Hive formSubmissions::i events, fired when a form in the workspace is submitted.

FormsWebhooks

Form Submission Updated Webhook`hive_webhook_form_submission_updated`

Processes Hive formSubmissions::u events, fired when a submitted form entry in the workspace is updated.

FormsWebhooks

Message Created Webhook`hive_webhook_message_created`

Processes Hive messages::i events, fired when a comment is added to an action or a message is posted in a chat group or...

MessagesWebhooks


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