Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Linear is a project management tool built for development teams to track issues, plan sprints, and coordinate work. Connecting Linear to Duvo lets your assignments create, update, and manage issues directly in your Linear workspace as part of automated workflows.

Setup

Click Enable on the Connections page and authorize with your Linear account.

Admin approval on Enterprise workspaces

If your Linear workspace is on the Enterprise plan and has third-party application approvals enabled, a workspace admin needs to approve Duvo once before members can connect. When a non-admin clicks Enable, Linear prompts them to request approval instead of completing authorization — an admin then approves Duvo workspace-wide from Linear’s settings. On Free, Standard, and Plus workspaces, or on Enterprise workspaces without approvals enabled, any member can connect their own account directly.

Capabilities

  • Create and update issues — Open new issues with titles, descriptions, and priorities, or update existing ones as workflows progress.
  • Manage comments and attachments — Add context to issues by posting comments, attaching files, or downloading existing attachments.
  • Organize with labels — Create, apply, and remove labels to keep issues categorized and easy to find.
  • Retrieve project and team data — Pull issue details, list projects, view team members, and access cycle or sprint information.
  • Run advanced queries — Execute custom queries for reporting or specialized data retrieval.
  • Linear triggers — Start a Job automatically when a Linear issue is created, assigned, changes workflow state, or gets a new comment. See Triggers for event types and filter options.

Triggers

Linear triggers fire in real time as activity happens in the Linear workspace you connected. Pick one event type per trigger, then narrow it down with optional filters.

Event types

EventStarts a Job when…
New issueA new issue is created.
Issue assignedAn issue is assigned to someone.
Issue state changedAn issue moves into a new workflow state (for example, from Started to Completed).
New commentA comment is posted on any issue.

Filters

All filters are optional. Leave a filter empty to match everything.
FilterApplies toWhat it does
TeamsAll eventsOnly fire for issues in specific Linear teams. Add one or more team keys (for example, ENG, DESIGN). Leave empty to match every team in the workspace.
AssigneeAll eventsOnly fire when the issue is assigned to a specific person. Add one or more Linear user IDs, or use me to match whoever connected Linear to Duvo.
Workflow stateNew issueOnly fire when the new issue lands in one of the selected state categories: Triage, Backlog, Unstarted, Started, Completed, or Canceled.
Destination stateIssue state changedOnly fire when the issue moves into one of the selected state categories: Triage, Backlog, Unstarted, Started, Completed, or Canceled.
Each matching Linear event starts its own Job, and the Job prompt includes the issue context (title, description, team, assignee, state) so the Assignment can act on it without extra lookups. The trigger watches the entire Linear workspace you connected — activity from any team or user in that workspace can match, subject to the filters above.

Key Benefits

  • Automated issue creation — Generate tickets automatically from workflow events, customer requests, or bug reports without manual entry.
  • Event-driven automation — Kick off Duvo workflows the moment a Linear event occurs — no polling, no manual triggers, no delays.
  • Synchronized tracking — Keep Linear updated in real time as your workflows execute and tasks complete.
  • Consistent documentation — Ensure every issue is created with complete, standardized information.
  • Less context switching — Let assignments handle routine issue management while you focus on higher-value work.

Works Well With

  • Gmail or Outlook — Automatically create Linear issues from incoming support emails or customer requests, keeping your inbox and backlog in sync.
  • Slack — Post issue updates to team channels when assignments create or close Linear issues, keeping everyone informed without manual status reports.
  • Confluence or Notion — Generate project summaries or sprint reports in your documentation tool based on Linear issue data.