API Token

Setup
Reference

What You'll Need

Credential	What it is
API Key	Personal API key from Linear settings

Overview

Connect Parable to Linear for issues, projects, and teams using the GraphQL API.

Issues & Projects

Issues, projects, cycles, milestones

Teams & Users

Team structure, user assignments

Prerequisites

Setup access in . These steps require , or a colleague with equivalent permissions who can create credentials for you.If that is not you, ask your administrator.

Admin role in Linear workspace (for full data access)
API keys are tied to your user account and its permissions

Setup Guide

Access Linear Settings

Go to linear.app
Click your avatar → Settings
Navigate to Account → Security & Access

Create API Key

Scroll to Personal API keys and click New API key
Enter label: Parable Integration
Choose permissions (full access or restricted) and click Create

Copy your now!This is the only time it will be displayed. Store it in a secure password manager before closing this page.

Note Permissions

The API key inherits your account’s permissions:

Admin users have access to all workspace data
Member users have access based on team membership

For comprehensive data access, create the key with an admin account.

Enter values in the form

API Key: Paste your Linear personal API key.
Click Save & test connection.

Verify Your Setup

curl -X POST "https://api.linear.app/graphql" \
  -H "Authorization: Bearer YOUR_LINEAR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ viewer { id email name } }"}'

curl -X POST "https://api.linear.app/graphql" \
  -H "Authorization: Bearer YOUR_LINEAR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ issues(first: 5) { nodes { id title } } }"}'

Success! If you received a 200 OK response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.

Rate Limits: enforces rate limits of .Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.

GraphQL Examples

Query Issues with Details

query {
  issues(first: 100) {
    nodes {
      id
      title
      description
      state { name }
      assignee { name email }
      project { name }
      labels { nodes { name } }
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Query Team Members

query {
  users {
    nodes {
      id
      name
      email
      active
      admin
    }
  }
}

Troubleshooting

Error	Meaning	Solution
`Authentication required`	Missing or invalid token	Verify API key in header
`Forbidden`	Insufficient permissions	Use admin account or check team access
`Rate limit exceeded`	Too many requests	Implement backoff

Common Issues

Can’t see certain teams

API keys inherit user permissions. If you can’t see certain teams, verify the user account has access.

GraphQL errors

Check your query syntax. Use Linear’s API explorer to test queries.

Additional Resources

Linear API

Official API documentation

GraphQL Schema

GraphQL reference

Release Notes

Connectors

What You'll Need

Overview

Issues & Projects

Teams & Users

Prerequisites

Setup Guide

Verify Your Setup

GraphQL Examples

Troubleshooting

Can’t see certain teams

GraphQL errors

Additional Resources

Linear API

GraphQL Schema

What You'll Need

​Overview

Issues & Projects

Teams & Users

​Prerequisites

​Setup Guide

​Verify Your Setup

​GraphQL Examples

​Troubleshooting

​Can’t see certain teams

​GraphQL errors

​Additional Resources

Linear API

GraphQL Schema

Overview

Prerequisites

Setup Guide

Verify Your Setup

GraphQL Examples

Troubleshooting

Can’t see certain teams

GraphQL errors

Additional Resources