Argo · AsyncAPI Specification

Argo Events

Version v1.9

Argo Events is a Kubernetes-native event-driven automation framework that listens to over 20 event sources and triggers Argo Workflows, Kubernetes objects, HTTP requests, and other actions in response. Event sources include webhooks, S3 bucket notifications, GitHub/GitLab webhooks, Kafka topics, NATS subjects, Redis streams, GCP Pub/Sub, SNS/SQS, cron schedules, and resource watches. Sensors define the event dependencies and trigger targets.

View Spec View on GitHub CNCFCI/CDGitOpsKubernetesOpen SourceProgressive DeliveryWorkflow EngineAsyncAPIWebhooksEvents

Channels

/webhook/{eventName}

subscribe receiveWebhookEvent

Receive an HTTP webhook event

HTTP webhook channel for receiving events from external systems such as GitHub, GitLab, Bitbucket, or custom HTTP callers. Each EventSource can define multiple named webhook endpoints on different ports.

/eventsource/{namespace}/{eventSourceName}/{eventName}

publish publishEventToEventBus

EventSource publishes event to EventBus

Internal EventBus channel through which EventSources publish events and Sensors consume them. The EventBus is backed by NATS JetStream or Apache Kafka depending on the EventBus configuration.

Messages

✉

WebhookEvent

Generic Webhook Event

A generic HTTP webhook payload received by an EventSource

✉

GitHubEvent

GitHub Webhook Event

A GitHub webhook event payload

✉

GitLabEvent

GitLab Webhook Event

A GitLab webhook event payload

✉

CloudEvent

Argo Events CloudEvent

A CloudEvents 1.0 envelope wrapping an Argo Events payload

Servers

http

argoEventsWebhook http://{eventsource-service}:{port}

Argo Events webhook EventSource service. Each EventSource that exposes an HTTP endpoint is deployed as a Kubernetes Service. The host and port depend on the EventSource configuration.