> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Connect Linear to your Atako agents — 20 read and 19 write actions.

Let your agents work in your Linear workspace — track, create and update issues, comments, projects and cycles on your behalf.

## Connection

* **Authentication**: API key (Personal API key (lin\_api\_...)).

<Note>
  Linear → Settings → Security & access (under Account) → Personal API keys → New API key. Name it, pick the minimal permission ("Read" for read-only agents, "Create issues" or "Write" if the agent must create/update data) and the teams it may access, then copy the key (starts with lin\_api\_).

  See [Linear's documentation](https://linear.app/settings/api).
</Note>

## Read actions (20)

| Action | Description |
| - | - |
| `get_attachment` | Fetch an issue attachment by ID. |
| `get_comment` | Fetch a comment by ID. |
| `get_cycle` | Fetch a cycle by ID. |
| `get_issue` | Fetch a single issue by ID or identifier (e.g. ENG-123). |
| `get_issue_label` | Fetch an issue label by ID. |
| `get_project` | Fetch a project by ID. |
| `get_team` | Fetch a team by ID. |
| `get_user` | Fetch a workspace user by ID. |
| `get_viewer` | Fetch the authenticated user (viewer) and its workspace identity. |
| `get_workflow_state` | Fetch a workflow state (issue status) by ID. |
| `list_attachments` | List the attachments of an issue. |
| `list_comments` | List comments on an issue. |
| `list_cycles` | List the cycles of a team. |
| `list_issue_labels` | List issue labels, optionally filtered by team. |
| `list_issues` | List issues, optionally filtered by team, assignee, workflow state or project. |
| `list_projects` | List projects in the workspace. |
| `list_teams` | List teams in the workspace. |
| `list_users` | List users in the workspace. |
| `list_workflow_states` | List the workflow states (issue statuses) of a team. |
| `search_issues` | Search issues by full-text term. |

## Write actions (19)

| Action | Description |
| - | - |
| `add_issue_label` | Add an existing label to an issue. |
| `archive_cycle` | Archive a cycle. |
| `archive_issue` | Archive an issue (optionally moving it to trash). |
| `create_attachment` | Attach an external URL to an issue. |
| `create_comment` | Post a comment on an issue (Markdown body). |
| `create_cycle` | Create a cycle for a team. |
| `create_issue` | Create an issue in a team. |
| `create_issue_label` | Create an issue label (team-scoped when teamId is given, else workspace-wide). |
| `create_issue_relation` | Relate two issues (blocks, duplicate or related). |
| `create_project` | Create a project attached to one or more teams. |
| `delete_attachment` | Delete an issue attachment. |
| `delete_comment` | Delete a comment. |
| `delete_issue` | Delete (trash) an issue permanently. |
| `delete_issue_label` | Delete an issue label. |
| `delete_issue_relation` | Delete an issue relation. |
| `remove_issue_label` | Remove a label from an issue. |
| `update_comment` | Edit the body of a comment. |
| `update_issue` | Update an issue (title, description, state, assignee, priority…). |
| `update_project` | Update a project (name, description, lead, dates…). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: July 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.