CloudEvents · AsyncAPI Specification

CloudEvents HTTP Delivery

Version 1.0

AsyncAPI definition for CloudEvents delivery over HTTP. This document describes the event-driven interface by which a CloudEvents-compatible broker pushes events to a subscriber's HTTP sink endpoint. Events are formatted as CloudEvents v1.0 and delivered in either structured content mode (application/cloudevents+json) or binary content mode (with CloudEvents attributes in HTTP headers). The subscriber's endpoint acts as an HTTP webhook that receives POST requests from the event broker.

View Spec View on GitHub Cloud NativeEventsGraduatedInteroperabilityMessagingSpecificationAsyncAPIWebhooksEvents

Channels

publish receiveCloudEvent

Receive a CloudEvent from the broker

The subscriber's sink endpoint receives HTTP POST requests from the CloudEvents broker. Each request carries one CloudEvent (single delivery mode) or a batch of CloudEvents (batch delivery mode). The subscriber acknowledges receipt with a 2xx HTTP response.

/batch

publish receiveCloudEventBatch

Receive a batch of CloudEvents from the broker

Batch delivery endpoint where the broker delivers multiple CloudEvents in a single HTTP POST request using the application/cloudevents-batch+json content type. Reduces per-event HTTP overhead for high-throughput scenarios.

Messages

✉

StructuredCloudEvent

CloudEvent (Structured Content Mode)

A single CloudEvent delivered in structured content mode where all event data including context attributes is encoded as a JSON object in the HTTP request body.

✉

BinaryCloudEvent

CloudEvent (Binary Content Mode)

A single CloudEvent delivered in binary content mode where CloudEvents context attributes are HTTP headers prefixed with 'ce-' and the event data is the raw HTTP body.

✉

BatchedCloudEvents

CloudEvents Batch

A batch of CloudEvents delivered in a single HTTP POST using the application/cloudevents-batch+json media type. Improves throughput by reducing per-event HTTP overhead.

Servers

https

subscriberSink {sinkUrl}

The subscriber's HTTP sink endpoint where the event broker delivers CloudEvents. Provided by the subscriber when creating a subscription.