chainctl events
This page presents some of the more commonly used chainctl events
commands. For a full reference of all commands with details and switches, see chainctl Reference.
There are three commands available: create, delete, and list. We’ll start with list to see what subscriptions exist.
View your event subscriptions
Get a list of all your Chainguard account’s subscriptions with:
chainctl events subscriptions list
This will return a list of IDs and SINKs for all of your subscriptions. You know what an ID is. A SINK is an addressable or callable resource that can receive incoming events delivered over HTTPS and will translate the delivered event into a returned response that includes promised information. The style and type of response is set by the SINK.
Create event subscriptions
To create a new event and subscribe to events in that organization or folder, use:
chainctl events subscriptions create $SINK_URL
Depending on the SINK, you may be prompted to respond to some questions before this action is complete. You can add a -y
to the command to automatically assume yes
and run without interaction.
Delete event subscriptions
To delete an existing event, use:
chainctl events subscriptions delete $SUBSCRIPTION_ID
Depending on the SINK, you may be prompted to respond to some questions before this action is complete. You can add a -y
to the command to automatically assume yes
and run without interaction.
Learn More
Chainguard Academy has several guides on CloudEvents. You may find our guide on Subscribing to Chainguard CloudEvents to be particularly useful for understanding how to work with events from Chainguard.
Last updated: 2025-03-06 08:49