WebhookDelivery Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "WebhookDelivery",
  "description": "One delivery attempt record for one event to one endpoint. An event and an endpoint share a single row for their whole life, so a repeat delivery rewrites this record rather than adding another.",
  "type": "object",
  "required": [
    "attempts",
    "created_at",
    "event_id",
    "event_type",
    "id",
    "next_attempt_at",
    "payload",
    "state"
  ],
  "properties": {
    "attempts": {
      "description": "Attempts made so far.",
      "type": "integer",
      "format": "int32",
      "example": 1
    },
    "created_at": {
      "description": "When the delivery was queued. A repeat delivery resets this to the moment it was requested.",
      "type": "string",
      "format": "date-time"
    },
    "delivered_at": {
      "description": "When the delivery landed. Null until it does.",
      "type": "string",
      "format": "date-time",
      "nullable": true
    },
    "event_id": {
      "description": "Event identifier, stable across retries and repeat deliveries. Deduplicate on this in your receiver.",
      "type": "string",
      "format": "uuid"
    },
    "event_type": {
      "description": "Event type delivered.",
      "type": "string",
      "example": "market.liquidation"
    },
    "id": {
      "description": "Delivery identifier.",
      "type": "string",
      "format": "uuid"
    },
    "last_error": {
      "description": "Why the last attempt failed. Null when it succeeded.",
      "type": "string",
      "nullable": true
    },
    "last_latency_ms": {
      "description": "How long the last attempt took, in milliseconds.",
      "type": "integer",
      "format": "int32",
      "nullable": true,
      "example": 142
    },
    "last_status_code": {
      "description": "HTTP status your receiver returned on the last attempt.",
      "type": "integer",
      "format": "int32",
      "nullable": true,
      "example": 200
    },
    "next_attempt_at": {
      "description": "When the next attempt is due.",
      "type": "string",
      "format": "date-time"
    },
    "payload": {
      "description": "The event body as sent, including its `id`, `type`, `schema_version`, `observed_at` and `data`.",
      "type": "object",
      "additionalProperties": true
    },
    "state": {
      "description": "`pending` is queued or waiting to retry, `delivered` landed, `failed` is the last attempt's result, and `exhausted` means the retry window closed without success.",
      "type": "string",
      "enum": [
        "pending",
        "delivered",
        "failed",
        "exhausted"
      ],
      "example": "delivered"
    }
  }
}