Events & schemas
This page provides a comprehensive reference of available event sources and their corresponding events with schemas for event subscriptions. All events include common metadata fields and follow a consistent structure.
Triggered when an application is created.
Example:
{ "type": "cf.access.application.created", "source": { "type": "access" }, "payload": { "id": "app-12345678-90ab-cdef-1234-567890abcdef", "name": "My Application" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when an application is deleted.
Example:
{ "type": "cf.access.application.deleted", "source": { "type": "access" }, "payload": { "id": "app-12345678-90ab-cdef-1234-567890abcdef", "name": "My Application" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Account-level events — Subscribe to the artifacts source to receive events for any repository in your account.
Triggered when a repository is created.
Example:
{ "type": "cf.artifacts.repo.created", "source": { "type": "artifacts", "namespace": "my-namespace", "repoName": "my-repo" }, "payload": { "repoId": "0tvugavnogssnwzk", "defaultBranch": "main", "description": "My Artifacts repository", "readOnly": false, "createdAt": "2026-05-18T15:53:46.833Z", "updatedAt": "2026-05-18T15:53:46.833Z", "lastPushAt": null }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2026-05-18T15:53:48.187Z" }}Triggered when a repository is deleted.
Example:
{ "type": "cf.artifacts.repo.deleted", "source": { "type": "artifacts", "namespace": "my-namespace", "repoName": "my-repo" }, "payload": { "repoId": "0tvugavnogssnwzk", "defaultBranch": "main", "description": "My Artifacts repository", "readOnly": false, "createdAt": "2026-05-18T15:53:46.833Z", "updatedAt": "2026-05-18T15:53:46.833Z", "lastPushAt": null }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2026-05-18T15:53:59.914Z" }}Triggered when a repository is forked.
Example:
{ "type": "cf.artifacts.repo.forked", "source": { "type": "artifacts", "namespace": "source-namespace", "repoName": "source-repo" }, "payload": { "namespace": "target-namespace", "repoName": "target-repo", "repoId": "5ankv1vhl4xnw7wq", "defaultBranch": "main", "description": "Fork of source-repo", "readOnly": false, "createdAt": "2026-05-18T15:53:52.384Z", "updatedAt": "2026-05-18T15:53:54.579Z", "lastPushAt": null }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2026-05-18T15:53:54.641Z" }}Triggered when a repository is imported from an external Git remote.
Example:
{ "type": "cf.artifacts.repo.imported", "source": { "type": "artifacts", "namespace": "my-namespace", "repoName": "my-repo" }, "payload": { "repoId": "d7nd72k964cv9kub", "defaultBranch": "main", "description": null, "readOnly": false, "createdAt": "2026-05-18T15:53:54.864Z", "updatedAt": "2026-05-18T15:53:57.737Z", "lastPushAt": null, "sourceUrl": "https://github.com/example/repo.git", "branch": "main" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2026-05-18T15:53:58.195Z" }}Repository-level events — Subscribe to the artifacts.repo source with a namespace and repo_name to receive events scoped to a single repository.
Triggered when commits are pushed to a repository.
Example:
{ "type": "cf.artifacts.repo.pushed", "source": { "type": "artifacts.repo", "namespace": "my-namespace", "repoName": "my-repo" }, "payload": { "ref": "refs/heads/main", "before": "abc123def456abc123def456abc123def456abc1", "after": "def789ghi012def789ghi012def789ghi012def7", "commits": [ { "id": "def789ghi012def789ghi012def789ghi012def7", "message": "Fix bug in authentication", "messageTruncated": false, "timestamp": "2025-05-01T02:48:57.000Z", "author": { "name": "Developer Name", "email": "developer@example.com" }, "committer": { "name": "Developer Name", "email": "developer@example.com" }, "parents": [ "abc123def456abc123def456abc123def456abc1" ] } ], "totalCommitsCount": 1, "commitsTruncated": false }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when a repository is cloned.
Example:
{ "type": "cf.artifacts.repo.cloned", "source": { "type": "artifacts.repo", "namespace": "my-namespace", "repoName": "my-repo" }, "payload": {}, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "0ab4c7b45a39491ba5da2973f3d093a6", "eventSchemaVersion": 1, "eventTimestamp": "2026-05-18T15:53:51.358Z" }}Triggered when updates are fetched from a repository.
Example:
{ "type": "cf.artifacts.repo.fetched", "source": { "type": "artifacts.repo", "namespace": "my-namespace", "repoName": "my-repo" }, "payload": {}, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "0ab4c7b45a39491ba5da2973f3d093a6", "eventSchemaVersion": 1, "eventTimestamp": "2026-05-18T15:53:51.358Z" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}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" }}Triggered when a build fails.
Example:
{ "type": "cf.workersBuilds.worker.build.failed", "source": { "type": "workersBuilds.worker", "workerName": "my-worker" }, "payload": { "buildUuid": "build-12345678-90ab-cdef-1234-567890abcdef", "status": "failed", "buildOutcome": "failure", "createdAt": "2025-05-01T02:48:57.132Z", "initializingAt": "2025-05-01T02:48:58.132Z", "runningAt": "2025-05-01T02:48:59.132Z", "stoppedAt": "2025-05-01T02:50:00.132Z", "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" }}Triggered when a build is canceled.
Example:
{ "type": "cf.workersBuilds.worker.build.canceled", "source": { "type": "workersBuilds.worker", "workerName": "my-worker" }, "payload": { "buildUuid": "build-12345678-90ab-cdef-1234-567890abcdef", "status": "canceled", "buildOutcome": "canceled", "createdAt": "2025-05-01T02:48:57.132Z", "initializingAt": "2025-05-01T02:48:58.132Z", "runningAt": "2025-05-01T02:48:59.132Z", "stoppedAt": "2025-05-01T02:49:30.132Z", "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" }}Triggered when a build succeeds.
Example:
{ "type": "cf.workersBuilds.worker.build.succeeded", "source": { "type": "workersBuilds.worker", "workerName": "my-worker" }, "payload": { "buildUuid": "build-12345678-90ab-cdef-1234-567890abcdef", "status": "success", "buildOutcome": "success", "createdAt": "2025-05-01T02:48:57.132Z", "initializingAt": "2025-05-01T02:48:58.132Z", "runningAt": "2025-05-01T02:48:59.132Z", "stoppedAt": "2025-05-01T02:50:15.132Z", "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" }}Triggered when a namespace is created.
Example:
{ "type": "cf.kv.namespace.created", "source": { "type": "kv" }, "payload": { "id": "ns-12345678-90ab-cdef-1234-567890abcdef", "name": "my-kv-namespace" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when a namespace is deleted.
Example:
{ "type": "cf.kv.namespace.deleted", "source": { "type": "kv" }, "payload": { "id": "ns-12345678-90ab-cdef-1234-567890abcdef", "name": "my-kv-namespace" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when an instance was created and is awaiting execution.
Example:
{ "type": "cf.workflows.workflow.instance.queued", "source": { "type": "workflows.workflow", "workflowName": "my-workflow" }, "payload": { "versionId": "v1", "instanceId": "inst-12345678-90ab-cdef-1234-567890abcdef" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when an instance starts or resumes execution.
Example:
{ "type": "cf.workflows.workflow.instance.started", "source": { "type": "workflows.workflow", "workflowName": "my-workflow" }, "payload": { "versionId": "v1", "instanceId": "inst-12345678-90ab-cdef-1234-567890abcdef" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when an instance pauses execution.
Example:
{ "type": "cf.workflows.workflow.instance.paused", "source": { "type": "workflows.workflow", "workflowName": "my-workflow" }, "payload": { "versionId": "v1", "instanceId": "inst-12345678-90ab-cdef-1234-567890abcdef" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when an instance step throws an error.
Example:
{ "type": "cf.workflows.workflow.instance.errored", "source": { "type": "workflows.workflow", "workflowName": "my-workflow" }, "payload": { "versionId": "v1", "instanceId": "inst-12345678-90ab-cdef-1234-567890abcdef" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when an instance is manually terminated.
Example:
{ "type": "cf.workflows.workflow.instance.terminated", "source": { "type": "workflows.workflow", "workflowName": "my-workflow" }, "payload": { "versionId": "v1", "instanceId": "inst-12345678-90ab-cdef-1234-567890abcdef" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}Triggered when an instance finishes execution successfully.
Example:
{ "type": "cf.workflows.workflow.instance.completed", "source": { "type": "workflows.workflow", "workflowName": "my-workflow" }, "payload": { "versionId": "v1", "instanceId": "inst-12345678-90ab-cdef-1234-567890abcdef" }, "metadata": { "accountId": "f9f79265f388666de8122cfb508d7776", "eventSubscriptionId": "1830c4bb612e43c3af7f4cada31fbf3f", "eventSchemaVersion": 1, "eventTimestamp": "2025-05-01T02:48:57.132Z" }}All events include these common fields:
| Field | Type | Description |
|---|---|---|
type | string | The event type identifier |
source | object | Contains source-specific information like IDs and names |
metadata.accountId | string | Your Cloudflare account ID |
metadata.eventSubscriptionId | string | The subscription that triggered this event |
metadata.eventSchemaVersion | number | The version of the event schema |
metadata.eventTimestamp | string | The ISO 8601 timestamp when the event occurred |
payload | object | The event-specific data containing details about what happened |