On Linear issue event

onLinearIssueEvent watches every issue lifecycle event in the connected workspace.

automations/watch-linear-issues.automation.ts

import { automation } from "automate.ax"
import { onLinearIssueEvent } from "automate.ax/linear"

export default automation("Watch Linear issues", () => {
  onLinearIssueEvent()
})

It accepts only optional static account, which defaults to the project binding. A signal cannot choose the workspace at runtime.

Trigger data

Returns a Signal<LinearIssueEvent>:

type LinearIssueEvent = LinearIssue & {
  event: LinearWebhookEvent<LinearIssue, "Issue">
}

interface LinearIssue {
  archivedAt?: string | null
  assignee?: LinearUser | null
  assigneeId?: string | null
  canceledAt?: string | null
  completedAt?: string | null
  createdAt: string
  creator?: LinearUser | null
  creatorId?: string | null
  description?: string | null
  dueDate?: string | null
  estimate?: number | null
  id: string
  identifier: string
  labelIds: string[]
  labels: LinearLabel[]
  number: number
  parentId?: string | null
  priority: number
  priorityLabel: string
  project?: LinearProjectReference | null
  projectId?: string | null
  startedAt?: string | null
  state: LinearWorkflowState
  stateId: string
  subscriberIds: string[]
  team?: LinearTeam | null
  teamId: string
  title: string
  trashed?: boolean | null
  updatedAt: string
  url: string
}

interface LinearWebhookEvent<TData, TType extends string> {
  action: "create" | "update" | "remove"
  actor?: LinearActor | null
  createdAt: string
  data: TData
  organizationId: string
  type: TType
  updatedFrom?: Record<string, JSONValue>
  url?: string
  webhookId: string
  webhookTimestamp: number
}

interface LinearUser {
  avatarUrl?: string | null
  email: string
  id: string
  name: string
  url: string
}

interface LinearLabel {
  color: string
  id: string
  name: string
  parentId?: string | null
}

interface LinearProjectReference {
  id: string
  name: string
  url: string
}

interface LinearWorkflowState {
  color: string
  id: string
  name: string
  type: string
}

interface LinearTeam {
  id: string
  key: string
  name: string
}

interface LinearActor {
  email?: string
  id?: string
  name?: string
  type?: string
  url?: string
}

Provider fields that Linear adds remain available on the typed resource objects and webhook envelope. Returns the changed issue directly, including typed id, identifier, title, timestamps, priority, workflow state, team, project, assignee, and labels. The original provider payload is available as event; inspect event.action to distinguish create, update, and remove, or use event.updatedFrom for previous values. Call getLinearIssue when you need the latest normalized issue after the webhook.

Get started

Concepts

Reference

On Linear issue event

Trigger data

​Trigger data

Trigger data