Skip to main content
HTTP API connector 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

​
Generate a Linear API Key

  1. Log in to your 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 1
  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.
  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.

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