# Hive

> Manage Hive workspaces, projects, tasks, comments and labels.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/hive

## Actions

### Add comment

Add comment.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Action (`action_id`, text, required): actionId identifier.
- Body (`body`, text, required): Body.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```

### Create label

Create label.

**Inputs**

- Workspace (`workspace_id`, text, required): workspaceId identifier.
- Name (`name`, text, required): Name.
- Color (`color`, text, required): Hex color such as #3390dc.
- Parent (`parent`, text): Parent.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```

### Create project

Create project.

**Inputs**

- Name (`name`, text, required): Name.
- Workspace (`workspace_id`, text, required): Workspace id.
- Description (`description`, text): Description.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```

### Create task

Create task.

**Inputs**

- Title (`title`, text, required): Title.
- Workspace (`workspace_id`, text, required): Workspace.
- Project (`project_id`, text): Project id.
- Description (`description`, text): Description.
- Assignees (`assignees`, list): Assignees.
- Assigned to (`assigned_to`, text): Zapier-compatible assignee field.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```

### Delete project

Delete project.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Project (`project_id`, text, required): projectId identifier.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "message": "example"
  }
}
```

### Delete task

Delete task.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Action (`action_id`, text, required): actionId identifier.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "message": "example"
  }
}
```

### Get project

Get project.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Project (`project_id`, text, required): projectId identifier.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```

### Get task

Get task.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Action (`action_id`, text, required): actionId identifier.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```

### List labels

List labels. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text, required): workspaceId identifier.
- First (`first`, number): Number of results from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.
- Sort by (`sort_by`, text): Supported fields: name, createdAt. Direction: asc or desc.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List project statuses

List project statuses. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text, required): workspaceId identifier.
- First (`first`, number): Number of results from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List projects

List projects. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text, required): workspaceId identifier.
- First (`first`, number): Number of results from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.
- Total count (`total_count`, true/false): When true, include totalCount in pageInfo.
- Sort by (`sort_by`, text): Sort expression: field asc|desc. Common fields: createdAt, modifiedAt, rank.
- Filters archived (`filters_archived`, true/false): Filter by archived state. V2 includes archived projects by default unless filtered.
- Filters parent project (`filters_parent_project`, text): Filter by parent project ID.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List subtasks

List subtasks. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Action (`action_id`, text, required): actionId identifier.
- First (`first`, number): Number of results to return from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results to return from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.
- Total count (`total_count`, true/false): When true, includes totalCount in pageInfo where supported.
- Sort by (`sort_by`, text): Sort expression in the form "field asc" or "field desc". Supported fields vary by endpoint.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List task history

List task history. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Action (`action_id`, text, required): actionId identifier.
- First (`first`, number): Number of results to return from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results to return from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.
- Total count (`total_count`, true/false): When true, includes totalCount in pageInfo where supported.
- Sort by (`sort_by`, text): Sort expression in the form "field asc" or "field desc". Supported fields vary by endpoint.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List tasks

List tasks. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text, required): workspaceId identifier.
- First (`first`, number): Number of results from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.
- Total count (`total_count`, true/false): When present, include totalCount. This route treats any non-empty query-string value, including false, as enabled.
- Sort by (`sort_by`, text): Sort expression: field asc|desc. Allowed fields: _id, rank, description, workspace, deleted, deadline, parent, projectId, archived, modifiedAt, createdAt, priorityLevelId, checkedDate.
- Project (`project_id`, text): Optional project ID to restrict actions to one project.
- Start date (`start_date`, text): Optional lower deadline bound. Use date format 'yyyy-mm-dd'.
- End date (`end_date`, text): Optional upper deadline bound. Use date format 'yyyy-mm-dd'.
- Filters status (`filters_status`, text): Filter by action status.
- Filters parent (`filters_parent`, text): Filter by parent action ID.
- Filters archived (`filters_archived`, true/false): Filter by archived state.
- Filters milestone (`filters_milestone`, true/false): Filter by milestone flag.
- Filters deleted (`filters_deleted`, true/false): Filter by deleted state.
- Filters root (`filters_root`, text): Filter by root action ID.
- Filters recurring id (`filters_recurring_id`, text): Filter by recurring action ID.
- Filters team assignee (`filters_team_assignee`, text): Filter by team assignee ID.
- Filters placeholder assignees (`filters_placeholder_assignees`, text): Filter by placeholder assignee ID.
- Filters priority level id (`filters_priority_level_id`, text): Filter by priority level ID.
- Filters following user ids (`filters_following_user_ids`, text): Filter by following user ID.
- Filters custom field custom field id (`filters_custom_field_custom_field_id`, text): Filter by custom field value. Formula fields are not supported.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List teams

List teams. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text, required): Workspace ID.
- First (`first`, number): Number of results from the start of the list. Do not combine with last.
- Last (`last`, number): Number of results from the end of the list. Do not combine with first.
- After (`after`, text): Cursor from a previous response for forward pagination.
- Before (`before`, text): Cursor from a previous response for backward pagination.
- Total count (`total_count`, true/false): When true, include totalCount in pageInfo.
- Sort by (`sort_by`, text): Sort expression: field asc|desc. Supported fields depend on the endpoint.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List users

List users. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text, required): workspaceId identifier.
- First (`first`, number): Number of results from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.
- Total count (`total_count`, true/false): When true, include totalCount in pageInfo.
- Sort by (`sort_by`, text): Only createdAt is supported.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### List workspaces

List workspaces. Returns one page; use the continuation fields for more results.

**Inputs**

- First (`first`, number): Number of results to return from the start of the list. Do not combine with last. From 1 to 200.
- Last (`last`, number): Number of results to return from the end of the list. Do not combine with first. From 1 to 200.
- After (`after`, text): Cursor returned by a previous response for forward pagination.
- Before (`before`, text): Cursor returned by a previous response for backward pagination.
- Total count (`total_count`, true/false): When true, includes totalCount in pageInfo where supported.
- Sort by (`sort_by`, text): Sort expression in the form "field asc" or "field desc". Supported fields vary by endpoint.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {
    "edges": [],
    "pageInfo": {
      "endCursor": "example",
      "hasNextPage": false,
      "hasPreviousPage": false,
      "startCursor": "example",
      "totalCount": 1
    }
  }
}
```

### Search tasks

Search tasks. Returns one page; use the continuation fields for more results.

**Inputs**

- Workspace (`workspace_id`, text, required): workspaceId identifier.
- Search term (`search_term`, text, required): Search text. Required.
- Project (`project_id`, text): Optional project ID to restrict search.
- Start date (`start_date`, text): Optional lower date bound. Use date format 'yyyy-mm-dd'.
- End date (`end_date`, text): Optional upper date bound. Use date format 'yyyy-mm-dd'.
- Limit (`limit`, number): Maximum results, clamped between 1 and 200. Defaults to 20. From 1 to 200. Default: `20`.
- Skip (`skip`, number): Number of results to skip. Defaults to 0. At least 0. Default: `0`.
- Sort by (`sort_by`, text): Search sort type. Supported values: modifiedAt, urgency, deadline, priority. Defaults to modifiedAt. One of: `modifiedAt`, `urgency`, `deadline`, `priority`.
- Filters label (`filters_label`, text): Filter by label.
- Filters assignee (`filters_assignee`, text): Filter by assignee.
- Filters placeholder assignee (`filters_placeholder_assignee`, text): Filter by placeholder assignee.
- Filters team (`filters_team`, text): Filter by team.
- Filters status (`filters_status`, text): Filter by status.
- Filters archived (`filters_archived`, true/false): Include archived results when true.

**Outputs**

- `data` (list): Service response.

**Example output**

```json
{
  "data": []
}
```

### Update project

Update project.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Project (`project_id`, text, required): projectId identifier.
- Name (`name`, text): Name.
- Description (`description`, text): Description.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```

### Update task

Update task.

**Inputs**

- Workspace (`workspace_id`, text): Workspace used to load the project or task dropdown. Leave empty when supplying an ID.
- Action (`action_id`, text, required): actionId identifier.
- Title (`title`, text): Title.
- Description (`description`, text): Description.
- Assignees (`assignees`, list): Assignees.
- Due date (`due_date`, date and time): Due date.
- Status (`status`, text): Status.

**Outputs**

- `data` (object): Service response.

**Example output**

```json
{
  "data": {}
}
```
