> ## 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 that are available.

<div className="connector-page-header">
  <img src="https://stackone-logos.com/api/hive/filled/svg" alt="Hive" className="connector-page-icon" />

  <div className="connector-page-changelog">
    <div className="connector-page-version"><span className="connector-page-tag-preview connector-page-stage-tag">Preview</span><span>v1.1.0</span></div>
    <div><a href="/connectors/hive/changelog">See changelog</a></div>
  </div>

  <div className="connector-page-header-meta">
    <div className="connector-page-subtitle"><a href="#actions">29 actions</a> · 1 auth method</div>

    <div className="connector-page-category-tags">
      <span className="connector-page-category-tag">Project Management</span>
      <span className="connector-page-category-tag">IAM</span>
    </div>
  </div>
</div>

## Getting Started

<Steps>
  <Step title="Create or Select a Project">
    Set up a new project or select an existing one. See [Organizations & Projects](/gateway/concepts/organizations-and-projects).
  </Step>

  <Step title="Configure the Connector">
    Enable the connector and set up a Connector Profile in your project. See [Setup Connector Profile](/gateway/quickstart#setup-connector-profile).

    <Columns cols={2}>
      <Card title="Connector Profile · API Key" href="/connectors/hive/guides/connector-profile/api-key" icon="https://stackone-logos.com/api/hive/filled/svg" horizontal>
        The steps in this guide require access to your Hive account to generate an API key and locate your User ID.
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Link an account [from the dashboard](/connect/managing-connectors/linking-accounts#link-from-the-dashboard) (or via [StackOne Hub](/embed/account-linking/overview)).

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

    <Columns cols={2}>
      <Card title="Link Account · API Key" href="/connectors/hive/guides/link-account/api-key" icon="https://stackone-logos.com/api/hive/filled/svg" horizontal />
    </Columns>
  </Step>

  <Step title="Use Actions">
    Connect an AI platform to the linked account's actions. See [AI Platforms](/connect/ai-platforms/overview).

    Other ways to call actions are listed in [Protocols & SDKs](/connect/protocols-and-sdks).
  </Step>
</Steps>

## Actions

<div className="connector-meta-library-section">
  <div className="connector-actions-controls not-prose" data-connector-actions-controls>
    <div className="connector-actions-controls__row">
      <input type="search" className="connector-actions-search" data-connector-actions-search placeholder="Search actions" aria-label="Search actions" />
    </div>
  </div>

  <div className="meta-library-count" data-connector-actions-count>29 actions</div>

  <div className="not-prose meta-library-table-container" data-connector-actions-table>
    <div className="connector-meta-library-grid">
      <div className="connector-meta-library-row">
        <div className="meta-library-grid-header-cell">Action</div>
        <div className="meta-library-grid-header-cell">Description</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_list_actions" data-action-label="List Actions" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Actions</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_list_actions" aria-label="Copy hive_list_actions"><code className="connector-page-code">hive\_list\_actions</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve all actions (tasks) within a specific workspace.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_get_action" data-action-label="Get Action" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Action</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_get_action" aria-label="Copy hive_get_action"><code className="connector-page-code">hive\_get\_action</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a specific action (task) by its ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_create_action" data-action-label="Create Action" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Action</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_create_action" aria-label="Copy hive_create_action"><code className="connector-page-code">hive\_create\_action</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a new action (task) in Hive.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_update_action" data-action-label="Update Action" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Action</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_update_action" aria-label="Copy hive_update_action"><code className="connector-page-code">hive\_update\_action</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update an existing action's properties.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_delete_action" data-action-label="Delete Action" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Delete Action</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_delete_action" aria-label="Copy hive_delete_action"><code className="connector-page-code">hive\_delete\_action</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Delete an action (task) by its ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_list_action_comments" data-action-label="List Action Comments" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Action Comments</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_list_action_comments" aria-label="Copy hive_list_action_comments"><code className="connector-page-code">hive\_list\_action\_comments</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve all comments on a specific Hive action (task).</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_create_action_comment" data-action-label="Create Action Comment" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Action Comment</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_create_action_comment" aria-label="Copy hive_create_action_comment"><code className="connector-page-code">hive\_create\_action\_comment</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add a new comment to a specific action.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_get_me" data-action-label="Get Unified Credentials" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified Credentials</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_get_me" aria-label="Copy hive_unified_get_me"><code className="connector-page-code">hive\_unified\_get\_me</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Return the authenticated identity and auth type for the current Hive connection. Hive has no /me endpoint; this action u...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_list_groups" data-action-label="List Unified Groups" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Groups</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_list_groups" aria-label="Copy hive_unified_list_groups"><code className="connector-page-code">hive\_unified\_list\_groups</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List Hive workspaces as IAM groups. Hive workspaces are the natural unit of grouping (containers for projects, actions,...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_get_group" data-action-label="Get Unified Group" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified Group</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_get_group" aria-label="Copy hive_unified_get_group"><code className="connector-page-code">hive\_unified\_get\_group</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a single Hive workspace by id, mapped to the IAM unified group schema, optionally expanding members.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_list_organizations" data-action-label="List Unified Organizations" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Organizations</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_list_organizations" aria-label="Copy hive_unified_list_organizations"><code className="connector-page-code">hive\_unified\_list\_organizations</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List the synthesized Hive organization. Hive has no /accounts or /tenants endpoint; this action returns a single synthet...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_get_organization" data-action-label="Get Unified Organization" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified Organization</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_get_organization" aria-label="Copy hive_unified_get_organization"><code className="connector-page-code">hive\_unified\_get\_organization</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve the synthesized Hive organization. Hive has no /accounts or /tenants endpoint, so this action returns the singl...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_list_roles" data-action-label="List Unified Roles" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Roles</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_list_roles" aria-label="Copy hive_unified_list_roles"><code className="connector-page-code">hive\_unified\_list\_roles</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Return Hive's five documented workspace roles (External User, Member, Admin, System Admin, Restricted User). Hive's role...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_get_role" data-action-label="Get Unified Role" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified Role</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_get_role" aria-label="Copy hive_unified_get_role"><code className="connector-page-code">hive\_unified\_get\_role</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve one of Hive's five documented workspace roles (External User, Member, Admin, System Admin, Restricted User) by...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_list_users" data-action-label="List Unified Users" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Users</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_list_users" aria-label="Copy hive_unified_list_users"><code className="connector-page-code">hive\_unified\_list\_users</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List Hive workspace members mapped to the IAM unified user schema. When filter.group\_id is provided, returns members of...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_unified_get_user" data-action-label="Get Unified User" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified User</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_unified_get_user" aria-label="Copy hive_unified_get_user"><code className="connector-page-code">hive\_unified\_get\_user</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a single Hive user by id. Hive has no /users/\{id} endpoint; this action fans out across all workspaces accessib...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_list_labels" data-action-label="List Labels" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Labels</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_list_labels" aria-label="Copy hive_list_labels"><code className="connector-page-code">hive\_list\_labels</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve all labels within a specific workspace.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_get_label" data-action-label="Get Label" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Label</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_get_label" aria-label="Copy hive_get_label"><code className="connector-page-code">hive\_get\_label</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a specific label within a workspace.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_create_label" data-action-label="Create Label" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Label</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_create_label" aria-label="Copy hive_create_label"><code className="connector-page-code">hive\_create\_label</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a new label in a Hive workspace.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_update_label" data-action-label="Update Label" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Label</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_update_label" aria-label="Copy hive_update_label"><code className="connector-page-code">hive\_update\_label</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update an existing label's properties in a workspace.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_delete_label" data-action-label="Delete Label" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Delete Label</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_delete_label" aria-label="Copy hive_delete_label"><code className="connector-page-code">hive\_delete\_label</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Delete a label from a workspace.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_list_projects" data-action-label="List Projects" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Projects</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_list_projects" aria-label="Copy hive_list_projects"><code className="connector-page-code">hive\_list\_projects</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve all projects within a specific workspace.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_get_project" data-action-label="Get Project" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Project</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_get_project" aria-label="Copy hive_get_project"><code className="connector-page-code">hive\_get\_project</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a specific project by its ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_create_project" data-action-label="Create Project" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Project</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_create_project" aria-label="Copy hive_create_project"><code className="connector-page-code">hive\_create\_project</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a new project in Hive.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_update_project" data-action-label="Update Project" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Project</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_update_project" aria-label="Copy hive_update_project"><code className="connector-page-code">hive\_update\_project</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update an existing project's properties.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_delete_project" data-action-label="Delete Project" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Delete Project</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_delete_project" aria-label="Copy hive_delete_project"><code className="connector-page-code">hive\_delete\_project</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Delete a project by its ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_list_workspaces" data-action-label="List Workspaces" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Workspaces</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_list_workspaces" aria-label="Copy hive_list_workspaces"><code className="connector-page-code">hive\_list\_workspaces</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve all workspaces accessible to the authenticated user.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_get_workspace" data-action-label="Get Workspace" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Workspace</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_get_workspace" aria-label="Copy hive_get_workspace"><code className="connector-page-code">hive\_get\_workspace</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a specific workspace by its ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="hive_list_workspace_users" data-action-label="List Workspace Users" data-action-scopes="" data-action-auth="API Key" data-action-auth-scopes="{&#x22;API Key&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Workspace Users</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="hive_list_workspace_users" aria-label="Copy hive_list_workspace_users"><code className="connector-page-code">hive\_list\_workspace\_users</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve all users belonging to a specific workspace.</div>
      </div>
    </div>
  </div>
</div>