Linear API: Complete developer integration guide 2025

# Generate API key:
# 1. Go to Linear Settings → API
# 2. Create new personal API key
# 3. Store securely in environment variables

LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxxx

// Using Apollo Client
import { ApolloClient, InMemoryCache, createHttpLink } from '@apollo/client';
import { setContext } from '@apollo/client/link/context';

const httpLink = createHttpLink({
  uri: 'https://api.linear.app/graphql',
});

const authLink = setContext((_, { headers }) => ({
  headers: {
    ...headers,
    authorization: `Bearer ${process.env.LINEAR_API_KEY}`,
  }
}));

const client = new ApolloClient({
  link: authLink.concat(httpLink),
  cache: new InMemoryCache(),
});

// Fetch issues query
const GET_ISSUES = gql`
  query GetIssues($filter: IssueFilter) {
    issues(filter: $filter) {
      nodes {
        id
        title
        description
        state {
          name
        }
        assignee {
          name
          email
        }
        createdAt
        updatedAt
      }
    }
  }
`;

// Create issue mutation
const CREATE_ISSUE = gql`
  mutation CreateIssue($input: IssueCreateInput!) {
    issueCreate(input: $input) {
      success
      issue {
        id
        title
        url
      }
    }
  }
`;

// Usage
const { data } = await client.mutate({
  mutation: CREATE_ISSUE,
  variables: {
    input: {
      title: "New feature request",
      description: "Detailed description",
      teamId: "team_id_here",
      priority: 2
    }
  }
});

// Pagination example
const getAllIssues = async () => {
  let allIssues = [];
  let hasNextPage = true;
  let cursor = null;

  while (hasNextPage) {
    const { data } = await client.query({
      query: GET_ISSUES_PAGINATED,
      variables: { after: cursor }
    });

    allIssues = allIssues.concat(data.issues.nodes);
    hasNextPage = data.issues.pageInfo.hasNextPage;
    cursor = data.issues.pageInfo.endCursor;
  }

  return allIssues;
};