Skip to main content
Linear’s GraphQL API exposes the full state of your engineering workflow: issues, cycles, labels, projects, and velocity metrics. These three jobs pull structured data from Linear into Mavera (Generate, Focus Groups, Mave Agent) to automate release content from completed features, run synthetic focus groups on customer-reported bugs, and align marketing launch timelines with engineering cycle velocity.

​
API Reference Card

All examples use LINEAR_API_KEY (a Personal API Key from Linear Settings → API) and MAVERA_API_KEY. Personal API keys inherit the permissions of the user who created them.

​
Prerequisites

1

Create a Linear API key

Go to linear.app/settings/api → Personal API Keys → Create Key. Copy the key immediately — it is only shown once.
2

Identify team and project IDs

Every Linear team, project, cycle, and issue has a UUID. Find them via the API or from URLs: linear.app/{workspace}/issue/{ISSUE-ID}.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

​
Jobs

​
Rate Limits & Production Notes

Linear charges complexity points per query based on nesting depth and connection sizes. Monitor usage via X-Complexity response headers and keep queries under 10,000 points each. For production, use Linear webhooks instead of polling to stay within limits.
Production checklist:
  • Auth: Personal keys don’t expire but can be revoked. For automations, use OAuth 2.0 with a service account.
  • Pagination: Connections accept first (max 250) and after (cursor). Follow pageInfo.hasNextPage.
  • Filtering: Use query-level filters (eq, in, gte, contains) instead of client-side filtering.
  • Webhooks: For release notes, trigger on issue state changes instead of polling.
  • Idempotency: Track processed issue IDs to avoid duplicate content generation.
  • Mavera credits: Monitor at Dashboard.

All Integrations

Linear API Docs

Focus Groups

Mave Agent

Generate