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

# Hive

> Hive is a project management and team collaboration platform for managing actions, projects, workflows, resources, and workspace metadata.

![Hive logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/hive.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=f0e44265c8045e983bd0547bc92cc5bd)

* **Category:** project management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `HIVE`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Action
>
> **Slug:** `HIVE_CREATE_ACTION`
>
> Create a Hive action (task) in a workspace, optionally inside a project and assigned to users.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Short task title.
>
> **project\_id** `string`
>
> Optional project in which to create the action.
>
> **description** `string`
>
> Optional task details.
>
> **assignee\_ids** `array`
>
> Optional Hive user IDs to assign.
>
> **workspace\_id** `string` *required*
>
> Workspace that will own the action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Label
>
> **Slug:** `HIVE_CREATE_LABEL`
>
> Create a color-coded label in a Hive workspace.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Label name.
>
> **color** `string` *required*
>
> Six-digit hex color including '#', for example #3390dc.
>
> **workspace\_id** `string` *required*
>
> Workspace that will own the label.
>
> **parent\_label\_id** `string`
>
> Optional parent label ID for a nested label.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Action
>
> **Slug:** `HIVE_DELETE_ACTION`
>
> Soft-delete one Hive action by ID. Hive preserves soft-delete semantics; this tool does not permanently erase the action. Deleting an action that is already gone succeeds rather than failing.
>
> #### Input Parameters
>
> **action\_id** `string` *required*
>
> Hive action ID to soft-delete. Use only an action the caller intends to remove.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Label
>
> **Slug:** `HIVE_DELETE_LABEL`
>
> Delete one label from a Hive workspace. Deleting a label that is already gone succeeds rather than failing.
>
> #### Input Parameters
>
> **label\_id** `string` *required*
>
> Label ID (\_id from Hive) to delete.
>
> **workspace\_id** `string` *required*
>
> Workspace that owns the label.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Action
>
> **Slug:** `HIVE_GET_ACTION`
>
> Get the current details of one Hive action by ID.
>
> #### Input Parameters
>
> **action\_id** `string` *required*
>
> Hive action ID returned by an action list, search, or create call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Actions
>
> **Slug:** `HIVE_LIST_ACTIONS`
>
> List Hive actions in a workspace, optionally narrowed by project, status, dates, hierarchy, or archive state.
>
> #### Input Parameters
>
> **first** `integer`
>
> Maximum actions to return in this forward page (1-200).
>
> **status** `string`
>
> Filter by exact Hive action status.
>
> **deleted** `boolean`
>
> Filter by soft-deleted state.
>
> **sort\_by** `string ("_id asc" | "_id desc" | "rank asc" | "rank desc" | "description asc" | "description desc" | "workspace asc" | "workspace desc" | "deleted asc" | "deleted desc" | "deadline asc" | "deadline desc" | "parent asc" | "parent desc" | "projectId asc" | "projectId desc" | "archived asc" | "archived desc" | "modifiedAt asc" | "modifiedAt desc" | "createdAt asc" | "createdAt desc" | "priorityLevelId asc" | "priorityLevelId desc" | "checkedDate asc" | "checkedDate desc")`
>
> Sort actions by a supported Hive field in ascending or descending order.
>
> **archived** `boolean`
>
> Filter by archived state.
>
> **end\_date** `string`
>
> Upper deadline bound in YYYY-MM-DD format.
>
> **project\_id** `string`
>
> Restrict actions to one project.
>
> **start\_date** `string`
>
> Lower deadline bound in YYYY-MM-DD format.
>
> **next\_cursor** `string`
>
> Cursor from a previous response; omit for the first page.
>
> **workspace\_id** `string` *required*
>
> Hive workspace ID from HIVE\_LIST\_WORKSPACES.
>
> **parent\_action\_id** `string`
>
> Return direct children of this parent action.
>
> **include\_total\_count** `boolean`
>
> Request pageInfo.totalCount when true. False is omitted because Hive treats any serialized value as enabled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Labels
>
> **Slug:** `HIVE_LIST_LABELS`
>
> List labels configured in a Hive workspace and return label IDs usable in action search.
>
> #### Input Parameters
>
> **first** `integer`
>
> Maximum labels to return in this forward page (1-200).
>
> **sort\_by** `string ("name asc" | "name desc" | "createdAt asc" | "createdAt desc")`
>
> Sort labels by name or creation time in ascending or descending order.
>
> **next\_cursor** `string`
>
> Cursor from a previous response; omit for the first page.
>
> **workspace\_id** `string` *required*
>
> Hive workspace ID from HIVE\_LIST\_WORKSPACES.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Projects
>
> **Slug:** `HIVE_LIST_PROJECTS`
>
> List projects accessible in a Hive workspace, with optional archive and parent-project filters. Archived projects are included by default.
>
> #### Input Parameters
>
> **first** `integer`
>
> Maximum projects to return in this forward page (1-200).
>
> **sort\_by** `string ("createdAt asc" | "createdAt desc" | "modifiedAt asc" | "modifiedAt desc" | "rank asc" | "rank desc")`
>
> Sort projects by creation time, modification time, or rank in ascending or descending order.
>
> **archived** `boolean`
>
> Filter projects by archived state; omit to include both active and archived projects.
>
> **next\_cursor** `string`
>
> Cursor from a previous response; omit for the first page.
>
> **workspace\_id** `string` *required*
>
> Hive workspace ID from HIVE\_LIST\_WORKSPACES.
>
> **parent\_project\_id** `string`
>
> Return only children of this parent project ID.
>
> **include\_total\_count** `boolean`
>
> Request pageInfo.totalCount when true; treat it as advisory because visibility may differ from totalCount.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workspaces
>
> **Slug:** `HIVE_LIST_WORKSPACES`
>
> List Hive workspaces accessible to the connected API key and return IDs needed by workspace-scoped tools.
>
> #### Input Parameters
>
> **first** `integer`
>
> Maximum workspaces to return in this forward page (1-200).
>
> **next\_cursor** `string`
>
> Cursor from a previous response; omit for the first page.
>
> **include\_total\_count** `boolean`
>
> Request pageInfo.totalCount when true; false is omitted upstream.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Actions
>
> **Slug:** `HIVE_SEARCH_ACTIONS`
>
> Search action titles in a Hive workspace and return one offset-based result page.
>
> #### Input Parameters
>
> **skip** `integer`
>
> Number of matching actions to skip; increase by limit for the next page.
>
> **limit** `integer`
>
> Maximum results in this page (1-200).
>
> **status** `string`
>
> Filter by exact Hive action status.
>
> **sort\_by** `string ("modifiedAt" | "urgency" | "deadline" | "priority")`
>
> Sort mode: modifiedAt, urgency, deadline, or priority.
>
> **archived** `boolean`
>
> Include or exclude archived results.
>
> **end\_date** `string`
>
> Upper date bound in YYYY-MM-DD format.
>
> **label\_id** `string`
>
> Filter by label ID.
>
> **project\_id** `string`
>
> Restrict search to one project.
>
> **start\_date** `string`
>
> Lower date bound in YYYY-MM-DD format.
>
> **assignee\_id** `string`
>
> Filter by assignee user ID.
>
> **search\_term** `string` *required*
>
> Text to match against action titles.
>
> **workspace\_id** `string` *required*
>
> Hive workspace ID from HIVE\_LIST\_WORKSPACES.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
