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

# Linear

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

## Prerequisites

The following examples require Linear API key, which can be obtained from [here](https://linear.app/settings/account/security).

```shell theme={null}
export LINEAR_API_KEY="LINEAR_API_KEY"
```

## Example

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

```python cookbook/14_tools/linear_tools.py theme={null}
from agno.agent import Agent
from agno.tools.linear import LinearTools

agent = Agent(
    name="Linear Tool Agent",
    tools=[LinearTools()],
        markdown=True,
)

agent.print_response("Show all the issues assigned to user id: 12021")
```

## Toolkit Params

| Parameter | Type  | Default | Description         |
| --------- | ----- | ------- | ------------------- |
| `api_key` | `str` | `None`  | Add Linear API key. |

## Toolkit Functions

| 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).          |

You can use `include_tools` or `exclude_tools` to modify the list of tools the agent has access to. Learn more about [selecting tools](/tools/selecting-tools).

## Developer Resources

* View [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/linear.py)