> For the complete documentation index, see [llms.txt](https://docs.projectbit.ca/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.projectbit.ca/documentation/tools/linear.md).

# Linear

**LinearTool** enable an Agent to perform [Linear](https://linear.app/) tasks.

### [​](https://docs.phidata.com/tools/linear#prerequisites)Prerequisites <a href="#prerequisites" id="prerequisites"></a>

```shell
export LINEAR_API_KEY="LINEAR_API_KEY"
```

### [​](https://docs.phidata.com/tools/linear#example)Example <a href="#example" id="example"></a>

The following agent will use Linear API to search for issues in a project for a specific user.

cookbook/tools/linear\_tools.py

```python
from bitca.agent import Agent
from bitca.tools.linear_tools import LinearTool

agent = Agent(
    name="Linear Tool Agent",
    tools=[LinearTool()],
    show_tool_calls=True,
    markdown=True,
)
agent.print_response("Show all the issues assigned to user id: 12021")

```

### [​](https://docs.phidata.com/tools/linear#toolkit-params)Toolkit Params <a href="#toolkit-params" id="toolkit-params"></a>

| Parameter                  | Type   | Default | Description                             |
| -------------------------- | ------ | ------- | --------------------------------------- |
| `get_user_details`         | `bool` | `True`  | Enable `get_user_details` tool.         |
| `get_issue_details`        | `bool` | `True`  | Enable `get_issue_details` tool.        |
| `create_issue`             | `bool` | `True`  | Enable `create_issue` tool.             |
| `update_issue`             | `bool` | `True`  | Enable `update_issue` tool.             |
| `get_user_assigned_issues` | `bool` | `True`  | Enable `get_user_assigned_issues` tool. |
| `get_workflow_issues`      | `bool` | `True`  | Enable `get_workflow_issues` tool.      |
| `get_high_priority_issues` | `bool` | `True`  | Enable `get_high_priority_issues` tool. |

### [​](https://docs.phidata.com/tools/linear#toolkit-functions)Toolkit Functions <a href="#toolkit-functions" id="toolkit-functions"></a>

| Function                   | Description                                                      |
| -------------------------- | ---------------------------------------------------------------- |
| `get_user_details`         | Fetch authenticated user details.                                |
| `get_issue_details`        | Retrieve details of a specific issue by issue ID.                |
| `create_issue`             | Create a new issue within a specific project and team.           |
| `update_issue`             | Update the title or state of a specific issue by issue ID.       |
| `get_user_assigned_issues` | Retrieve issues assigned to a specific user by user ID.          |
| `get_workflow_issues`      | Retrieve issues within a specific workflow state by workflow ID. |
| `get_high_priority_issues` | Retrieve issues with a high priority (priority `<=` 2).          |