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

# Linear

> Connect Linear to xpander and give agents its 35 actions: how to connect it, and which actions to hold for approval.

<Badge color="blue">HTTP API connector</Badge>

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go through xpander's function endpoint `https://functions.xpander.ai/`, which fronts the Linear API, and carry the credential the connect dialog asks for.

## What the skill can do

API connector: 35 actions, as they appear in the skill panel. 16 of them create, change or delete something in Linear; mark those under **These actions need approval** when you add the skill to an agent.

* **Comment service** (6): Get Comment by ID, Get List of Comments, Get List of Issues, Create New Comment, Delete Comment, Update Existing Comment
* **Attachment service** (4): Delete Attachment, Get Attachment by ID, Get List of Attachments, Create New Attachment
* **Issue tracking** (4): Get Issue by ID, Delete Issue, Create New Issue, Update Existing Issue
* **Label management** (4): Create New Label, Get List of Labels, Get Label by ID, Archive Label
* **Project management** (4): Get Project by ID, Create New Project, Get List of Projects, Archive Project
* **Team management** (4): Update Existing Team, Get List of Teams, Create New Team, Get Team by ID
* **User management** (3): Get List of Users, Get User by ID, Get Authenticated User Info
* **Cycle management** (3): Create New Cycle, Get Cycle by ID, Get List of Cycles
* **Workflow state management** (3): Get List of Workflow States, Create Workflow State, Get Workflow State by ID

## Authentication Options

<Tabs>
  <Tab title="API Access">
    ### Generate a Linear API Key

    1. Log in to your [Linear app](https://linear.app/).

    2. Click on your avatar and select **Settings** from the dropdown menu.

    3. In the sidebar, click **Security & access**.

    4. In the **Personal API keys** section, click **New API key**.\\
           <img src="https://mintcdn.com/xpanderai-099931d1/MfbW8wufR8EyGOUW/images/connectors/linear/img_1.png?fit=max&auto=format&n=MfbW8wufR8EyGOUW&q=85&s=0a2ce6df3f1479184b5c9c9a2147132c" alt="Img 1" width="2377" height="1206" data-path="images/connectors/linear/img_1.png" />

    5. Enter a name for the key, assign the appropriate permissions, and click **Create**.

    6. Save the API key.

    ### Connect Linear in xpander

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Linear** and select it.
    3. Enter a **connection name**, e.g., "xpander-linear".
    4. Choose **Organization** access (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](/use/agents/permissions#whose-credential-a-shared-agent-uses).
    5. Select **API key** as the authentication method.
    6. Paste the Linear API key into the provided field.
    7. Choose **Custom header** as the **Type**.
    8. In the **Header name** field, enter `Authorization`.
    9. Click **Connect**.
  </Tab>
</Tabs>

## Give an agent the Linear skill

Once Linear is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Linear**. The skill panel lists the Linear actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](/use/skills).

## Related Resources

* [Skills](/use/skills)
* [Linear API Documentation](https://linear.app/developers)


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