# Linear

Linear is a modern issue-tracking and project management tool designed for high-performance teams. It streamlines workflows, enhances collaboration, and integrates with development tools to optimize task management and software project tracking.

#### **How to Connect Linear to ZBrain Flow?** <a href="#how-to-connect-linear-to-zbrain-flow" id="how-to-connect-linear-to-zbrain-flow"></a>

To integrate Linear with ZBrain Flow, follow these steps to select and utilize the desired capabilities:

1. **Search for the Linear Component**: Search the Linear component within the ZBrain interface.
2. **Select the Required Capability**: Select the desired element, as per requirement:

* **Create Issue:** Create a new issue in Linear workspace
* **Update Issue:** Update a issue in Linear Workspace
* **Create Project:** Create a new project in Linear workspace
* **Update Project:** Update an existing project in Linear workspace
* **Create Comment:** Create a new comment on an issue in Linear workspace
* **Raw GraphQL query:** Perform a raw GraphQL query

#### **Additional Settings to Create Linear Connection** <a href="#additional-settings-to-create-linear-connection" id="additional-settings-to-create-linear-connection"></a>

To obtain your API key, follow these steps:

1. **Obtain API key:** Go to settings by clicking your profile-pic (top-left)
2. **Create Key:** Go to API section inside My Account. On Personal API keys, give label and press create key.
3. **Connection Name** - Enter a name to identify this Linear connection.
4. **API Key** - Provide your Linear API key for authentication.

#### **Additional Settings to** **Create Issue**  <a href="#additional-settings-to-create-issue" id="additional-settings-to-create-issue"></a>

1. **API Key** - Provide your Linear API key for authentication.
2. **Connection** - Select an existing Linear connection or create a new one.
3. **Team** - Choose the team where the issue, project, or comment will be created.
4. **Title** - Enter the title of the issue to be created.
5. **Description** - Add additional details or context about the issue.
6. **Status** - Select the current status of the issue (e.g., Open, In Progress).
7. **Labels** - Assign relevant labels to categorize the issue.
8. **Assignee** - Select the user responsible for this issue or comment.
9. **Priority** - Define the priority level of the issue (e.g., High, Medium, Low).
10. **Template** - Choose a predefined template for the issue, if applicable.

#### **Additional Settings to** **Update Issue** <a href="#additional-settings-to-update-issue" id="additional-settings-to-update-issue"></a>

1. **API Key** - Enter your Linear API key for authentication.
2. **Connection** - Select or create a Linear connection to update an issue.
3. **Team** - Choose the team where the issue is located.
4. **Issue** - Select the ID of the issue to be updated.
5. **Title** - Modify the title of the issue.
6. **Description** - Update the description or details of the issue.
7. **Status** - Change the current status of the issue (e.g., Open, Closed).
8. **Labels** - Add or modify labels assigned to the issue.
9. **Assignee** - Reassign the issue to a different user if needed.
10. **Priority** - Adjust the priority level of the issue.

#### **Additional Settings to** **Create Project** <a href="#additional-settings-to-create-project" id="additional-settings-to-create-project"></a>

1. **API Key** - Enter your Linear API key for authentication.
2. **Connection** - Select or create a Linear connection to create a project.
3. **Team** - Choose the team where the project will be created.
4. **Project Name** - Specify the name of the project.
5. **Description** - Provide additional details or objectives of the project.
6. **Icon** - Set an icon to visually represent the project.
7. **Color** - Assign a color to the project for easy identification.
8. **Start Date** - Define the start date of the project.
9. **Target Date** - Set the deadline or completion date of the project.

#### **Additional Settings to** **Update Project** <a href="#additional-settings-to-update-project" id="additional-settings-to-update-project"></a>

1. **API Key** - Enter your Linear API key for authentication.
2. **Connection** - Select or create a Linear connection to update a project.
3. **Team** - Choose the team where the project belongs.
4. **Project** - Select the project you want to update.
5. **Project Name** - Enter a new name for the project.
6. **Description** - Update or modify the project's details.
7. **Icon** - Change the icon to visually represent the project.
8. **Color** - Assign a new color to the project for better identification.
9. **Start Date** - Modify the project's start date.
10. **Target Date** - Adjust the deadline or expected completion date.

#### **Additional Settings to** **Create Comment** <a href="#additional-settings-to-create-comment" id="additional-settings-to-create-comment"></a>

1. **API Key** - Enter your Linear API key for authentication.
2. **Connection** - Select or create a Linear connection to post a comment.
3. **Team** - Choose the team where the issue is assigned.
4. **Assignee** - Select the user responsible for the comment.
5. **Issue** - Choose the issue where the comment will be posted.
6. **Comment Body** - Enter the content of the comment.

#### **Additional Settings for Raw GraphQL Query**  <a href="#additional-settings-for-raw-graphql-query" id="additional-settings-for-raw-graphql-query"></a>

1. **API Key** - Enter your Linear API key for authentication.
2. **Connection** - Select or create a Linear connection to execute a query.
3. **Query** - Input the GraphQL query to fetch or modify data in Linear.
4. **Parameters** - Add optional parameters for dynamic query execution.