# Hive integration

> Hive project management API: workspaces, projects, actions (tasks), users, teams, labels, custom fields, resource assignments, webhooks, workflows and SCIM provisioning.

- Authentication: apiKey

## Tools (104)

- **Add action attachment**: Adds an attachment from a URL. Body requires url and may include filename.
- **Add project custom field**: Adds or reuses a project custom field and attaches it to the project.
- **Add team members**: Adds users to a team and returns the team.
- **Apply workflow template to action**: Applies a workflow/template to an existing action. Body requires processId.
- **Bulk update actions**: Bulk updates up to 1000 actions. Each action object must include _id and may include allowed update fields.
- **Copy project**: Copies an existing project. Body requires projectId and name.
- **Create action**: Creates an action using the v2 action resource endpoint.
- **Create action comment**: Creates a comment on an action. Body requires body.
- **Create activity feed**: Creates an activity feed item in a workspace. Body must include a valid type, bucket, and attachedItemType.
- **Create a team**: Creates a team.
- **Create custom field**: Creates a workspace custom field.
- **Create custom tag**: Creates a custom tag and optional options.
- **Create label**: Creates a workspace label.
- **Create project**: Creates a project.
- **Create project status**: Creates a project status.
- **Create resource assignment**: Creates a resource assignment.
- **Create role tag**: Creates a role tag.
- **Create webhook**: Creates a webhook endpoint.
- **Delete action**: Deletes one action by ID, preserving Hive soft-delete semantics.
- **Delete a team**: Deletes a team. Answers 204 with no body.
- **Delete custom tag**: Deletes one custom tag.
- **Delete label**: Deletes one label by ID.
- **Delete project**: Deletes one project by ID.
- **Delete project custom field**: Disables a custom field on a project.
- **Delete resource assignment**: Deletes one resource assignment.
- **Delete role tag**: Deletes a role tag.
- **Delete webhook**: Deletes a webhook owned by the authenticated user.
- **Export a list widget**: Exports a list widget's rows.
- **Export dashboard widget data**: Returns a temporary download URL for a CSV export of dashboard widget data. Large exports may take several minutes.
- **Get action**: Retrieves one action by ID.
- **Get action attachment**: Retrieves one action attachment by ID.
- **Get agile sprint**: Retrieves one agile sprint by ID.
- **Get a user**: Returns a user who shares a workspace with the authenticated user.
- **Get a widget export job**: Returns the status of a dashboard widget export job and, when finished, the download URL.
- **Get custom field**: Retrieves one workspace custom field. Note: if workspace lookup fails, current server behavior may return no response; prefer valid workspace-scoped IDs.
- **Get custom tag**: Retrieves one custom tag.
- **Get dashboard widget data**: Returns processed dashboard widget data. Provide user_filter_id, or provide workspace_id so the server can locate the dashboard user filter.
- **Get label**: Retrieves one label by ID.
- **Get project**: Retrieves one project by ID.
- **Get project status**: Retrieves one project status by ID.
- **Get project tag assignment**: Retrieves one custom tag assignment for a project.
- **Get resource assignment**: Retrieves one resource assignment.
- **Get user role tag**: Gets the role tag assigned to a user.
- **Get user settings**: Returns a member's workspace settings: firstDayOfWork, lastDayOfWork, billRate, costRate and managers.
- **Get user tag assignment**: Retrieves one custom tag assignment for a user.
- **Invite a workspace member**: Invites a user by email. External members cannot invite.
- **List action attachments**: Returns cursor-paginated file and Hive Drive attachments for an action.
- **List action comments**: Returns cursor-paginated comments for an action.
- **List action history**: Returns cursor-paginated history items for an action.
- **List agile sprints**: Returns cursor-paginated agile sprints for a workspace.
- **List custom fields**: Returns cursor-paginated workspace custom fields. Supports label filter and sortBy.
- **List custom tags**: Lists workspace custom tags. Optional type query filters by tag type.
- **List external members**: Lists the external members of a workspace, cursor paginated. Sort by createdAt.
- **List form submissions**: Lists a form's submissions, cursor paginated. Requires workspace membership and the Forms feature; restricted forms are visible to their viewer teams, creator and admins.
- **List groups**: Returns cursor-paginated groups for a workspace.
- **List labels**: Returns cursor-paginated labels. totalCount is always included by the current implementation.
- **List projects**: Returns projects accessible to the authenticated user.
- **List project statuses**: Returns cursor-paginated project statuses sorted by createdAt. totalCount is always included by the current implementation; sortBy is not supported.
- **List project tags**: Lists custom tag assignments for a project.
- **List project users**: Returns users visible on a project.
- **List removed members**: Lists users removed from the workspace, newest removal first (removedAt).
- **List resource assignments**: Returns cursor-paginated resource assignments sorted by createdAt. totalCount is always included by the current implementation; sortBy is not supported.
- **List role tags**: Lists workspace role tags.
- **List subactions**: Returns cursor-paginated subactions for an action.
- **List teams**: Lists the workspace's teams, cursor paginated.
- **List users**: Lists users who share a workspace with the authenticated user, cursor paginated. Sort by createdAt.
- **List user tags**: Returns user tag assignments. External workspace members are allowed by this API route when authenticated.
- **List versioned files**: Returns cursor-paginated proofing versioned files accessible to the authenticated user.
- **List workflows**: Returns cursor-paginated workflows for a workspace.
- **List workspace actions**: Returns cursor-paginated actions accessible to the authenticated user, as edges and pageInfo.
- **List workspace members**: Lists the members of a workspace, cursor paginated. Sort by createdAt.
- **List workspace projects**: Returns cursor-paginated projects accessible to the authenticated user. Archived projects are included by default; use filters[archived] to narrow.
- **List workspaces**: Returns cursor-paginated workspaces accessible to the authenticated user.
- **Post a message to a group**: Posts an automated message to a group the authenticated user belongs to.
- **Remove a workspace member**: Removes a member from the workspace. Requires the workspace.edit permission.
- **Remove team members**: Removes users from a team and returns the team.
- **SCIM Create group**: Create a new group (team) in the workspace with an optional initial list of members.
- **SCIM Create user**: Provision a new user into the workspace. The user will be added as a workspace member.
- **SCIM Delete group**: Delete a group (team) from the workspace. This is a soft delete.
- **SCIM Delete user**: Remove a user from the workspace. This does not permanently delete the user's Hive account. The user is moved to the workspace's removed users list and can be re-provisioned later by creating them again or setting `active` to `true` via PUT.
- **SCIM Get group**: Retrieve a single group (team) by its Hive team ID.
- **SCIM Get user**: Retrieve a single user by their Hive user ID. The user must be a current or former member of the workspace.
- **SCIM List groups**: Retrieve a paginated list of groups (teams) in the workspace. Supports filtering by `displayName` (team name).
- **SCIM List users**: Retrieve a paginated list of users in the workspace. Supports filtering by `userName` (email address).
- **SCIM Replace group**: Full replacement of a group's attributes, including its name and member list.
- **SCIM Replace user**: Full replacement of a user's attributes. This operation can update the user's name, email, active status, and external ID.
- **SCIM Update group**: Partially update a group using SCIM PATCH operations.
- **SCIM Update user**: Partially update a user's attributes using SCIM PATCH operations.
- **Search actions**: Searches workspace actions by title. This endpoint uses limit/skip and returns an array, not cursor pagination.
- **Trigger an app workflow**: Triggers an enabled app workflow whose trigger is an API request. The payload is validated against the workflow's declared fields.
- **Trigger workflow**: Triggers a workflow by ID and creates/runs its action from the workflow template.
- **Update action**: Updates one action by ID.
- **Update a team**: Renames a team or replaces its members.
- **Update a user**: Updates a user profile. Users may update themselves; an organization admin may update users in the organization's workspaces.
- **Update custom tag**: Updates a custom tag name, multi-select setting, or options.
- **Update label**: Updates one label by ID.
- **Update project**: Updates mutable project fields such as name, dates, color, sharing, budget, archive state, and owners.
- **Update project custom field**: Updates a project custom field value or label.
- **Update project tag assignment**: Updates selected options for a project custom tag.
- **Update resource assignment**: Updates one resource assignment.
- **Update role tag**: Updates a role tag.
- **Update user role tag**: Assigns or changes a user role tag.
- **Update user settings**: Updates firstDayOfWork, lastDayOfWork, billRate, costRate or managers. Other fields are rejected.
- **Update user tag assignment**: Updates selected options for a user custom tag.

Connect Hive in General Input: https://www.generalinput.com/apps/hive