Documentation Index Fetch the complete documentation index at: https://docs.parable.work/llms.txt
Use this file to discover all available pages before exploring further.
What You'll Need Credential Description API Key Personal API key from Linear settings
Overview Connect to Linear’s GraphQL API for issue tracking and project management data.
Issues & Projects Issues, projects, cycles, milestones
Teams & Users Team structure, user assignments
Prerequisites Administrator access required. You need privileges in to complete this setup.If you don’t have admin access, contact your administrator to:
Create the API credentials on your behalf, OR
Grant you temporary admin access to complete the setup
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
Click your avatar → Settings
Navigate to Account → API
Create API Key
Click Create key
Enter label: Parable Integration
Click Create key
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 dataMember users have access based on team membership For comprehensive data access, create the key with an admin account.
Verify Your Setup Test with GraphQL
List Issues
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 } }"}'
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 { users { nodes { id name email active admin } } }
Troubleshooting Error Meaning Solution Authentication requiredMissing or invalid token Verify API key in header ForbiddenInsufficient permissions Use admin account or check team access Rate limit exceededToo many requests Implement backoff
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
