Skip to main content

Linear

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Linear workspace to Nirvai to manage issues, projects, and cycles programmatically using Linear's GraphQL API.

Supported Authentication Methods​

  • Personal API Key - Recommended for personal integrations

Prerequisites​

  • A Linear account (free or paid)
  • Access to the workspace you want to connect

Setup Instructions​

Generating a Personal API Key​

  1. Log in to your Linear workspace
  2. Click your avatar (bottom-left)
  3. Go to Settings
  4. Navigate to Security & access > API
  5. Under "Personal API keys", click Create key
  6. Enter a label for your key (e.g., "Nirvai Integration")
  7. Click Create
  8. Important: Copy the API key immediately - it won't be shown again
  9. In Nirvai, create a new Linear credential and paste the key

Alternative Path​

Access API settings directly at:

https://linear.app/settings/api

API Key Permissions​

Personal API keys:

  • Have full access to your Linear account
  • Can read and write issues, projects, cycles, etc.
  • Are scoped to workspaces you have access to
  • Don't expire but can be revoked

GraphQL API​

Linear uses a GraphQL API. Key features:

  • Single endpoint: https://api.linear.app/graphql
  • Flexible queries - request only the data you need
  • Real-time subscriptions available
  • Rich filtering and pagination

Troubleshooting​

Common Issues​

  • 401 Unauthorized: API key is invalid or was revoked. Generate a new key.
  • 403 Forbidden: You don't have permission for the requested resource.
  • Rate limits: Linear enforces rate limits. Implement backoff strategies.
  • Query complexity: GraphQL queries have complexity limits. Simplify if needed.

Managing API Keys​

To view or revoke existing keys:

  1. Go to Settings > Security & access > API
  2. View all active keys under "Personal API keys"
  3. Click the delete icon to revoke a key

Rate Limits​

Linear enforces these limits:

  • 1500 requests per hour (basic)
  • 6000 requests per hour (paid)
  • Query complexity limits apply
  • Headers indicate remaining quota

Best Practices​

API Key Security​

  • Never share or expose your API key
  • Don't commit keys to version control
  • Use environment variables
  • Revoke unused keys

Efficient Queries​

  • Request only fields you need
  • Use pagination for large lists
  • Leverage filtering at API level
  • Consider webhooks for real-time updates

Adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.