v4
latestOpenAPI 3.1.02026-08-07341215300.9 KBLinear 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"}