#LinkCodeDOCS
Docs/Webhooks

Event delivery

Product direction

React to LinkCode events.

Prepare for LinkCode webhooks with documented event envelopes, signature verification, delivery retries, idempotency and event ordering.

01

Planned event families

  • ✓code.created
  • ✓code.updated
  • ✓code.paused
  • ✓code.resolved
  • ✓asset.ready
  • ✓asset.failed
02

Proposed envelope

{
  "id": "evt_01K1...",
  "type": "code.resolved",
  "apiVersion": "2026-07-28",
  "createdAt": "2026-07-28T15:00:00Z",
  "workspaceId": "ws_01K1...",
  "data": {
    "code": "LAUNCH26",
    "routeId": "route_01K1...",
    "country": "CA"
  }
}
03

Signature verification

The production design will sign the exact raw request body, include a timestamp, reject stale deliveries and support overlapping secrets during rotation.