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

# Linear

> Connect Linear to your workflows: 59 operations across 9 categories.

The Linear node adds Linear operations to your workflows. Add it on the canvas or ask the AI builder for it by name, then pick an operation and fill in its fields.

Linear also includes 9 trigger operations (marked in the tables below) that can start a workflow when something happens in Linear.

<Note>
  You can wire the Linear node into an AI agent as a tool provider: the agent calls the operations you allow. See [Agent tools](/agents/tools).
</Note>

## Credentials

Connect Linear under **Credentials** in the node settings. See [Connecting credentials](/credentials/connecting) for the general flow.

### OAuth

Sign in with your Linear account when prompted; no keys to copy.

NoClick requests the following permissions:

* `read`
* `write`
* `issues:create`
* `comments:create`
* `admin`

### Personal access token

Enter the values manually when creating the credential.

[Get your credentials here](https://linear.app/settings/api).

## Operations

### Attachment

| Operation                   | ID                        | Description                              | Trigger |
| --------------------------- | ------------------------- | ---------------------------------------- | ------- |
| **Create Issue Attachment** | `create_issue_attachment` | Create an attachment (link URL to issue) |         |
| **Delete Attachment**       | `delete_attachment`       | Delete an attachment                     |         |
| **List Issue Attachments**  | `list_issue_attachments`  | List attachments for an issue            |         |

### Cycle

| Operation            | ID                 | Description                                | Trigger |
| -------------------- | ------------------ | ------------------------------------------ | ------- |
| **Archive Cycle**    | `archive_cycle`    | Archive a cycle                            |         |
| **Create Cycle**     | `create_cycle`     | Create a new cycle (sprint) for a team     |         |
| **List Team Cycles** | `list_team_cycles` | Retrieve cycles for a specific Linear team |         |
| **Update Cycle**     | `update_cycle`     | Update an existing cycle                   |         |

### Document

| Operation           | ID                | Description                                                                    | Trigger |
| ------------------- | ----------------- | ------------------------------------------------------------------------------ | ------- |
| **Create Document** | `create_document` | Create a new document. Requires exactly one of: projectId, teamId, or issueId. |         |
| **Delete Document** | `delete_document` | Delete a document                                                              |         |
| **Get Document**    | `get_document`    | Retrieve a Linear document by ID                                               |         |
| **List Documents**  | `list_documents`  | List documents in the user's Linear workspace                                  |         |
| **Update Document** | `update_document` | Update an existing document                                                    |         |

### Issue

| Operation                 | ID                      | Description                                        | Trigger |
| ------------------------- | ----------------------- | -------------------------------------------------- | ------- |
| **Archive Issue**         | `archive_issue`         | Archive an issue                                   |         |
| **Create Issue**          | `create_issue`          | Create a new Linear issue                          |         |
| **Create Issue Comment**  | `create_issue_comment`  | Create a comment on a specific Linear issue        |         |
| **Create Issue Label**    | `create_issue_label`    | Create a new Linear issue label                    |         |
| **Create Issue Relation** | `create_issue_relation` | Create a relation between issues                   |         |
| **Delete Issue**          | `delete_issue`          | Delete a Linear issue                              |         |
| **Delete Issue Comment**  | `delete_issue_comment`  | Delete a comment                                   |         |
| **Delete Issue Label**    | `delete_issue_label`    | Delete an issue label                              |         |
| **Delete Issue Relation** | `delete_issue_relation` | Delete an issue relation                           |         |
| **Get Issue**             | `get_issue`             | Retrieve detailed information about an issue by ID |         |
| **List Issue Comments**   | `list_issue_comments`   | List comments for a specific Linear issue          |         |
| **List Issue Labels**     | `list_issue_labels`     | List available issue labels in a Linear workspace  |         |
| **List Issue Relations**  | `list_issue_relations`  | List issue relations (blocks, related, duplicate)  |         |
| **List Issues**           | `list_issues`           | List issues in the user's Linear workspace         |         |
| **Search Issues**         | `search_issues`         | Search issues by query string                      |         |
| **Unarchive Issue**       | `unarchive_issue`       | Unarchive an issue                                 |         |
| **Update Issue**          | `update_issue`          | Update an existing Linear issue                    |         |
| **Update Issue Comment**  | `update_issue_comment`  | Update an existing comment                         |         |
| **Update Issue Label**    | `update_issue_label`    | Update an issue label                              |         |

### Project

| Operation                    | ID                         | Description                                  | Trigger |
| ---------------------------- | -------------------------- | -------------------------------------------- | ------- |
| **Archive Project**          | `archive_project`          | Archive a project (soft delete)              |         |
| **Create Project**           | `create_project`           | Create a new project in Linear               |         |
| **Create Project Milestone** | `create_project_milestone` | Create a project milestone                   |         |
| **Delete Project**           | `delete_project`           | Permanently delete a project                 |         |
| **Delete Project Milestone** | `delete_project_milestone` | Delete a project milestone                   |         |
| **Get Project**              | `get_project`              | Retrieve details of a specific project       |         |
| **List Project Milestones**  | `list_project_milestones`  | List milestones for a project                |         |
| **List Projects**            | `list_projects`            | List projects in the user's Linear workspace |         |
| **Update Project**           | `update_project`           | Update an existing Linear project            |         |
| **Update Project Milestone** | `update_project_milestone` | Update a project milestone                   |         |

### Team

| Operation                     | ID                          | Description                                | Trigger |
| ----------------------------- | --------------------------- | ------------------------------------------ | ------- |
| **Get Team**                  | `get_team`                  | Retrieve details of a specific Linear team |         |
| **List Team Workflow States** | `list_team_workflow_states` | List workflow states (statuses) for a team |         |
| **List Teams**                | `list_teams`                | List teams in the user's Linear workspace  |         |

### User

| Operation                  | ID                       | Description                                | Trigger |
| -------------------------- | ------------------------ | ------------------------------------------ | ------- |
| **Get Authenticated User** | `get_authenticated_user` | Get the currently authenticated user       |         |
| **Get User**               | `get_user`               | Retrieve details of a specific Linear user |         |
| **List Users**             | `list_users`             | Retrieve users in the Linear workspace     |         |

### Webhook

| Operation          | ID               | Description                        | Trigger |
| ------------------ | ---------------- | ---------------------------------- | ------- |
| **Create Webhook** | `create_webhook` | Create a webhook                   |         |
| **Delete Webhook** | `delete_webhook` | Delete a webhook                   |         |
| **List Webhooks**  | `list_webhooks`  | List webhooks for the organization |         |

### Other

| Operation              | ID                   | Description                                      | Trigger |
| ---------------------- | -------------------- | ------------------------------------------------ | ------- |
| **On Comment Created** | `on_comment_created` | Trigger: fires when a Linear comment is created. | Yes     |
| **On Comment Deleted** | `on_comment_deleted` | Trigger: fires when a Linear comment is deleted. | Yes     |
| **On Comment Updated** | `on_comment_updated` | Trigger: fires when a Linear comment is updated. | Yes     |
| **On Issue Created**   | `on_issue_created`   | Trigger: fires when a Linear issue is created.   | Yes     |
| **On Issue Deleted**   | `on_issue_deleted`   | Trigger: fires when a Linear issue is deleted.   | Yes     |
| **On Issue Updated**   | `on_issue_updated`   | Trigger: fires when a Linear issue is updated.   | Yes     |
| **On Project Created** | `on_project_created` | Trigger: fires when a Linear project is created. | Yes     |
| **On Project Deleted** | `on_project_deleted` | Trigger: fires when a Linear project is deleted. | Yes     |
| **On Project Updated** | `on_project_updated` | Trigger: fires when a Linear project is updated. | Yes     |
