Events & schemas·续1

Events & schemas·续1

`message.deferred`

Triggered when a temporary delivery failure occurs and delivery retries are still pending.

Example:

{
    "type": "cf.email.sending.message.deferred",
    "source": {
        "type": "email.sending",
        "zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
        "domain": "send.example.com"
    },
    "payload": {
        "eventId": "0190d0c4-7e9b-7714-9004-11f0b6d9a341",
        "messageId": "0101018f7d0c4d9a-msg-deferred",
        "sender": "receipts@send.example.com",
        "recipient": "user@example.net",
        "subject": "Your receipt",
        "terminal": false,
        "delivery": {
            "status": "deferred",
            "provider": "external_smtp",
            "deliveryTimeMs": 2143,
            "smtpStatusCode": "451",
            "smtpEnhancedStatusCode": "4.2.0",
            "smtpResponse": "451 4.2.0 Temporary mailbox error"
        },
        "bounce": {
            "type": "soft",
            "classification": "temporary_failure",
            "reason": "451 4.2.0 Temporary mailbox error"
        }
    },
    "metadata": {
        "accountId": "f9f79265f388666de8122cfb508d7776",
        "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
        "eventSchemaVersion": 1,
        "eventTimestamp": "2026-06-01T02:48:57.132Z"
    }
}

`message.bounced`

Triggered when a permanent bounce occurs, or when temporary delivery retries are exhausted.

Example:

{
    "type": "cf.email.sending.message.bounced",
    "source": {
        "type": "email.sending",
        "zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
        "domain": "send.example.com"
    },
    "payload": {
        "eventId": "0190d0c4-7ea1-7af2-8b88-c1d2e3f4a5b6",
        "messageId": "0101018f7d0c4d9a-msg-bounced",
        "sender": "receipts@send.example.com",
        "recipient": "user@example.net",
        "subject": "Your receipt",
        "terminal": true,
        "delivery": {
            "status": "bounced",
            "provider": "external_smtp",
            "deliveryTimeMs": 2143,
            "smtpStatusCode": "550",
            "smtpEnhancedStatusCode": "5.1.1",
            "smtpResponse": "550 5.1.1 User unknown"
        },
        "bounce": {
            "type": "hard",
            "classification": "permanent_failure",
            "reason": "550 5.1.1 User unknown"
        }
    },
    "metadata": {
        "accountId": "f9f79265f388666de8122cfb508d7776",
        "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
        "eventSchemaVersion": 1,
        "eventTimestamp": "2026-06-01T02:48:57.132Z"
    }
}

`message.failed`

Triggered when an internal or non-SMTP delivery error occurs.

Example:

{
    "type": "cf.email.sending.message.failed",
    "source": {
        "type": "email.sending",
        "zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
        "domain": "example.com"
    },
    "payload": {
        "eventId": "0190d0c4-81c1-7bc6-9344-829cd9001a12",
        "messageId": "0101018f7d0c4d9a-msg-failed",
        "sender": "noreply@example.com",
        "recipient": "user@example.net",
        "subject": "Welcome",
        "terminal": true,
        "delivery": {
            "status": "failed"
        },
        "failure": {
            "reason": "delivery_failed"
        }
    },
    "metadata": {
        "accountId": "f9f79265f388666de8122cfb508d7776",
        "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
        "eventSchemaVersion": 1,
        "eventTimestamp": "2026-06-01T02:48:57.132Z"
    }
}

`message.rejected`

Triggered when the message is rejected before delivery by policy, including suppression, validation rejection, or spam rejection.

Example:

{
    "type": "cf.email.sending.message.rejected",
    "source": {
        "type": "email.sending",
        "zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
        "domain": "example.com"
    },
    "payload": {
        "eventId": "0190d0c4-830a-77e5-8fa0-8d10f4e8dc8b",
        "messageId": "0101018f7d0c4d9a-msg-rejected",
        "sender": "noreply@example.com",
        "recipient": "user@example.net",
        "subject": "Welcome",
        "terminal": true,
        "delivery": {
            "status": "rejected"
        },
        "rejection": {
            "reason": "suppressed",
            "party": "recipient",
            "detail": "Recipient is suppressed"
        }
    },
    "metadata": {
        "accountId": "f9f79265f388666de8122cfb508d7776",
        "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
        "eventSchemaVersion": 1,
        "eventTimestamp": "2026-06-01T02:48:57.132Z"
    }
}

`message.complained`

Triggered when a delivered message is marked as spam by the recipient through a feedback loop.

Example:

{
    "type": "cf.email.sending.message.complained",
    "source": {
        "type": "email.sending",
        "zoneId": "023e105f4ecef8ad9ca31a8372d0c353",
        "domain": "send.example.com"
    },
    "payload": {
        "eventId": "0190d0c4-9f01-7c44-b2a1-aabbccddeeff",
        "messageId": "0101018f7d0c4d9a-msg-complained",
        "sender": "news@send.example.com",
        "recipient": "user@example.net",
        "terminal": true,
        "delivery": {
            "status": "complained"
        },
        "complaint": {
            "type": "abuse"
        }
    },
    "metadata": {
        "accountId": "f9f79265f388666de8122cfb508d7776",
        "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
        "eventSchemaVersion": 1,
        "eventTimestamp": "2026-06-01T02:48:57.132Z"
    }
}

R2

`bucket.created`

Triggered when a bucket is created.

Example:

{
  "type": "cf.r2.bucket.created",
  "source": {
    "type": "r2"
  },
  "payload": {
    "name": "my-bucket",
    "jurisdiction": "default",
    "location": "WNAM",
    "storageClass": "Standard"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`bucket.deleted`

Triggered when a bucket is deleted.

Example:

{
  "type": "cf.r2.bucket.deleted",
  "source": {
    "type": "r2"
  },
  "payload": {
    "name": "my-bucket",
    "jurisdiction": "default"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

Super Slurper

`job.started`

Triggered when a migration job starts.

Example:

{
  "type": "cf.superSlurper.job.started",
  "source": {
    "type": "superSlurper"
  },
  "payload": {
    "id": "job-12345678-90ab-cdef-1234-567890abcdef",
    "createdAt": "2025-05-01T02:48:57.132Z",
    "overwrite": true,
    "pathPrefix": "migrations/",
    "source": {
      "provider": "s3",
      "bucket": "source-bucket",
      "region": "us-east-1",
      "endpoint": "s3.amazonaws.com"
    },
    "destination": {
      "provider": "r2",
      "bucket": "destination-bucket",
      "jurisdiction": "default"
    }
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`job.paused`

Triggered when a migration job pauses.

Example:

{
  "type": "cf.superSlurper.job.paused",
  "source": {
    "type": "superSlurper"
  },
  "payload": {
    "id": "job-12345678-90ab-cdef-1234-567890abcdef"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`job.resumed`

Triggered when a migration job resumes.

Example:

{
  "type": "cf.superSlurper.job.resumed",
  "source": {
    "type": "superSlurper"
  },
  "payload": {
    "id": "job-12345678-90ab-cdef-1234-567890abcdef"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`job.completed`

Triggered when a migration job finishes.

Example:

{
  "type": "cf.superSlurper.job.completed",
  "source": {
    "type": "superSlurper"
  },
  "payload": {
    "id": "job-12345678-90ab-cdef-1234-567890abcdef",
    "totalObjectsCount": 1000,
    "skippedObjectsCount": 10,
    "migratedObjectsCount": 980,
    "failedObjectsCount": 10
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`job.aborted`

Triggered when a migration job is manually aborted.

Example:

{
  "type": "cf.superSlurper.job.aborted",
  "source": {
    "type": "superSlurper"
  },
  "payload": {
    "id": "job-12345678-90ab-cdef-1234-567890abcdef",
    "totalObjectsCount": 1000,
    "skippedObjectsCount": 100,
    "migratedObjectsCount": 500,
    "failedObjectsCount": 50
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`job.object.migrated`

Triggered when an object is migrated.

Example:

{
  "type": "cf.superSlurper.job.object.migrated",
  "source": {
    "type": "superSlurper.job",
    "jobId": "job-12345678-90ab-cdef-1234-567890abcdef"
  },
  "payload": {
    "key": "migrations/file.txt"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

Vectorize

`index.created`

Triggered when an index is created.

Example:

{
  "type": "cf.vectorize.index.created",
  "source": {
    "type": "vectorize"
  },
  "payload": {
    "name": "my-vector-index",
    "description": "Index for embeddings",
    "createdAt": "2025-05-01T02:48:57.132Z",
    "modifiedAt": "2025-05-01T02:48:57.132Z",
    "dimensions": 1536,
    "metric": "cosine"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`index.deleted`

Triggered when an index is deleted.

Example:

{
  "type": "cf.vectorize.index.deleted",
  "source": {
    "type": "vectorize"
  },
  "payload": {
    "name": "my-vector-index"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

Workers AI

`batch.queued`

Triggered when a batch request is queued.

Example:

{
  "type": "cf.workersAi.model.batch.queued",
  "source": {
    "type": "workersAi.model",
    "modelName": "@cf/baai/bge-base-en-v1.5"
  },
  "payload": {
    "requestId": "req-12345678-90ab-cdef-1234-567890abcdef"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`batch.succeeded`

Triggered when a batch request has completed.

Example:

{
  "type": "cf.workersAi.model.batch.succeeded",
  "source": {
    "type": "workersAi.model",
    "modelName": "@cf/baai/bge-base-en-v1.5"
  },
  "payload": {
    "requestId": "req-12345678-90ab-cdef-1234-567890abcdef"
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

`batch.failed`

Triggered when a batch request has failed.

Example:

{
  "type": "cf.workersAi.model.batch.failed",
  "source": {
    "type": "workersAi.model",
    "modelName": "@cf/baai/bge-base-en-v1.5"
  },
  "payload": {
    "requestId": "req-12345678-90ab-cdef-1234-567890abcdef",
    "message": "Model execution failed",
    "internalCode": 5001,
    "httpCode": 500
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}

Workers Builds

`build.started`

Triggered when a build starts.

Example:

{
  "type": "cf.workersBuilds.worker.build.started",
  "source": {
    "type": "workersBuilds.worker",
    "workerName": "my-worker"
  },
  "payload": {
    "buildUuid": "build-12345678-90ab-cdef-1234-567890abcdef",
    "status": "running",
    "buildOutcome": null,
    "createdAt": "2025-05-01T02:48:57.132Z",
    "initializingAt": "2025-05-01T02:48:58.132Z",
    "runningAt": "2025-05-01T02:48:59.132Z",
    "stoppedAt": null,
    "buildTriggerMetadata": {
      "buildTriggerSource": "push_event",
      "branch": "main",
      "commitHash": "abc123def456",
      "commitMessage": "Fix bug in authentication",
      "author": "developer@example.com",
      "buildCommand": "npm run build",
      "deployCommand": "wrangler deploy",
      "rootDirectory": "/",
      "repoName": "my-worker-repo",
      "providerAccountName": "github-user",
      "providerType": "github"
    }
  },
  "metadata": {
    "accountId": "f9f79265f388666de8122cfb508d7776",
    "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f",
    "eventSchemaVersion": 1,
    "eventTimestamp": "2025-05-01T02:48:57.132Z"
  }
}