linear

Linear GraphQL API

Use the Linear GraphQL API to manage issues, projects, cycles, and teams.

Setup Guide

Before using this skill, you need to create a Personal API key in Linear:

1. Create an API Key

1. Open Linear and click the gear icon (Settings)
2. Navigate to "Security & Access" in the left sidebar
3. Scroll to "Personal API keys" section
4. Click "Create key"
5. Give it a label (e.g., "Byaan")
6. Copy the key (starts with lin_api_)
7. Paste this key in Settings > Skills > Linear in the app

How Authentication Works

You do not need to handle authentication manually. When you call execute_skill_api(), the system automatically:

1. Retrieves the API key from the configured credentials
2. Adds the Authorization: <api_key> header (no Bearer prefix)
3. Sends POST request with the GraphQL query

Just call the API with skill name, endpoint path, and GraphQL query — authentication is handled for you.

How to Call the API

Linear uses GraphQL. Call execute_skill_api() with these parameters:

execute_skill_api(
  skill_name="linear",
  endpoint_path="/graphql",
  is_graphql=True,
  graphql_query="query { viewer { id name } }",
  graphql_variables="{}"  # Optional JSON string for variables
)

Parameters:

• skill_name: Always "linear"
• endpoint_path: Always "/graphql"
• is_graphql: Always True
• graphql_query: The GraphQL query or mutation string
• graphql_variables: Optional JSON string of variables for parameterized queries

Example with variables:

execute_skill_api(
  skill_name="linear",
  endpoint_path="/graphql",
  is_graphql=True,
  graphql_query="query GetIssue($id: String!) { issue(id: $id) { title } }",
  graphql_variables="{\"id\": \"ABC-123\"}"
)

Workflows

Creating an Issue

You must query for IDs before creating an issue. Here's the workflow:

1. Get team ID (required):

query {
  teams {
    nodes {
      id
      name
      key
    }
  }
}