v4

latestOpenAPI 3.1.02026-08-07341215300.9 KB

Linear Webhook

Webhook endpoint for Linear events.

Handles:

  • OAuthAuthorization revoked events: When Deeptrace integration is revoked, removes linear_oauth_token_id and linear-mcp from team config.
  • Issue create/update events: Triggers investigations when configured (feature-flagged).
  • AgentSessionEvent: Chat-style responses when @Deeptrace is mentioned, using Linear's Agent Interaction protocol (AgentActivity mutations).
  • Comment events: Ignored (agent mentions use AgentSessionEvent instead).

Linear webhook payload structure: { "action": "create" | "update" | "revoked" | "created" | "prompted", "type": "Issue" | "Comment" | "OAuthAuthorization" | "AgentSessionEvent", "organizationId": "...", "data": { ... } // for Issue/Comment "agentSession": { ... } // for AgentSessionEvent }

post/api/linear-webhook

Response

Successful Response

{"stackTrail":"paths:/api/linear-webhook:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}