Last updated:
Set Up Linear Integration
Connect Dash0 to your Linear workspace to enable Agent0 to look up issues, reference projects, and understand team structures during investigations. The integration also enables triggering Agent0 from Linear by mentioning @Dash0.
To create a Linear integration, navigate to Settings → Integrations, click + Add, and select Linear from the integration type list.
Prerequisites
Before setting up the Linear integration:
- Linear workspace with appropriate permissions
- Organization administrator role in Dash0
- Linear account with access to the target workspace
Setup
Connect Dash0 to your Linear workspace through an OAuth authorization flow. Review the full grant below before authorizing it; it includes write access beyond posting comments.
Configuration Steps
- Navigate to Settings → Integrations.
- Click + Add and select Linear.
- Click Connect Linear to begin OAuth authorization.
- A popup window opens for Linear authentication.
- Sign in to your Linear account.
- Select the Linear workspace to connect.
- Review the requested permissions, including read and write access.
- Click Authorize to grant Dash0 access.
- The popup closes automatically upon successful authorization.
- The integration appears in your integrations list.
Configuration
Configure OAuth permissions and understand what Agent0 can access in your Linear workspace.
OAuth Permissions
Dash0 requests the following Linear permissions for Agent0:
read: Read workspace data, including issues, teams, and projects.write: Write workspace data, not just investigation comments.app:assignableandapp:mentionable: Allow assignment to and mentions of the Dash0 app.initiative:readandinitiative:write: Read and write initiatives.
The OAuth grant and Agent0's available tools are separate. Read tools support investigations. Where enabled for your organization, additional tools can create or update Linear issues, comments, projects, milestones, initiatives, cycles, and documents. Automation guardrails further restrict which tools a run may use.
What Agent0 Can Access
Once connected, Agent0 can:
- Look up issues by keyword, team, or project
- Read issue details including status, assignee, priority, description, and comments
- Browse teams and projects to understand work organization
- Post investigation results as comments in Linear threads (when mentioned)
Manage the Integration
Open the Linear integration from Settings → Integrations to view its details or manage the application in Linear.
View Integration Details
The details page displays:
- Organization Name: The connected Linear workspace's name, displayed read-only.
- Workspace Slug: The workspace's slug, displayed read-only.
- Metadata: Creation and last-update dates and the members responsible, when available.
Click Manage in Linear to open the Dash0 application's settings in Linear. Managing the application there requires the appropriate Linear admin permissions.
The Dash0 details page does not display token health, refresh times, or recent activity, and it has no reconnect control.
Removing the Integration
You must be an organization Admin to delete the integration.
- Navigate to Settings → Integrations → Linear.
- Click the trash icon (Delete integration).
- Confirm with Delete.
- Agent0 can no longer access Linear issues or respond to @Dash0 mentions.
Deleting the integration in Dash0 does not fully revoke the application's access in Linear. A Linear admin must also remove the Dash0 application from the Linear workspace. The confirmation dialog links to its settings.
Troubleshooting
Common issues with the Linear integration and their solutions.
Authorization Failed
- Popup Blockers: Ensure popup windows are allowed for the Dash0 domain.
- Linear Permissions: Verify your Linear account has permission to authorize applications.
- Workspace Access: Ensure you have access to the Linear workspace you're trying to connect.
Agent0 Cannot Access Issues
- Workspace: Open the integration in Settings → Integrations and verify Organization Name and Workspace Slug match the workspace you want to query.
- Team Permissions: Verify Agent0 has access to the Linear teams you're querying.
@Dash0 Mentions Not Working
- Integration Connected: Verify the Linear integration is connected in Settings → Integrations.
- Bot Permissions: Ensure the Dash0 bot has permission to read and comment on issues.
- Workspace Match: Verify you're mentioning @Dash0 in the correct Linear workspace.
- Dash0 Identity: For conversational mentions, your Linear email must match a Dash0 account that is a member of the connected Dash0 organization. A matching automation trigger follows a separate execution path.
Security
Linear integration security relies on OAuth authentication, encrypted API calls, and audit logging.
OAuth Security
- Secure Authentication: OAuth tokens are stored encrypted at rest.
- Automatic Refresh: Tokens are automatically refreshed before expiration.
- Revocation: Delete the integration in Dash0 and have a Linear admin remove the Dash0 application from the Linear workspace to fully revoke access.
- Audit Trail: All Agent0 interactions with Linear are logged in Dash0 audit logs.
Data Privacy
The connection grants read and write access. Check which tools are enabled for your organization, and restrict automation tools with guardrails. Do not treat the integration as a read-only credential or assume that all writes require a Linear mention.
Further Reading
- Use Linear in Chat and Automations — How Agent0 uses Linear
- Use the Dash0 Linear Agent — Trigger Agent0 from Linear
- Integrations — All available Dash0 integrations
- Key Concepts — Reference terminology and mental model