Linear Integration

Use Linear integration to let Dawn discover teams, read issues and comments, and ground agent workflows in your Linear data.

Before you start

• A Linear account with access to the teams you want Dawn to use.
• A Linear personal API key.
• The default Linear GraphQL URL, https://api.linear.app/graphql, unless you use a proxy or custom endpoint.

Dawn does not require a Linear app install, webhook, or OAuth setup. The current integration uses a Linear personal API key and reads only the teams and issues available to that key.

Create the API key in Linear

1. Open Linear.
2. Go to Settings and then Account.
3. Open Security & Access.
4. Create a personal API key.
5. Name it something like Dawn Linear.
6. Copy the key and store it safely. Dawn expects the raw key value.

If you do not see the option to create a key, Linear may be blocking member API keys. Linear admins can allow them in Settings -> Administration -> API -> Member API keys. Admins can also create and use a key from an admin account that has access to the required teams.

Linear documents API keys and GraphQL access here: API and webhooks and GraphQL.

Connect Linear in Dawn

1. Open Integrations in Dawn and click Add connection.
2. Choose Linear.
3. Paste the personal API key into API key.
4. Leave API URL set to https://api.linear.app/graphql unless you have a custom setup.
5. Click Connect.
6. Review the discovered Linear teams and link the ones you want available in the workspace.
7. Assign those linked sources to the agents that should use them.

What Dawn discovers

Dawn discovers Linear teams and creates one team-scoped issue source per team. Each source is named <TEAM_KEY> - <TEAM_NAME> and uses a default team filter based on that team key.

Dawn currently surfaces issues and issue comments from those team sources. It does not create a separate board entity or require you to configure saved views in Linear.

Troubleshooting

• Invalid token: make sure you pasted the full Linear API key, without extra spaces, and that it is still active.
• Connection validates but no teams appear: the API key user likely does not have access to any teams visible to Dawn.
• A team is missing from discovery: confirm the API key user can open that team in Linear, then rerun discovery and link the new source.
• Provider unreachable: check outbound access to https://api.linear.app/graphql or verify that your custom API URL is correct.

Validate Linear team and issue retrieval across linked sources.

Check for pagination gaps in Linear issue reads.