CH·02CLI reference
gpu webhooks create
Register a webhook endpoint
Register a webhook endpoint
Synopsis
Registers an HTTPS endpoint and subscribes it to an explicit list of event types. The response includes the HMAC signing secret — it is shown ONCE and cannot be retrieved later, so store it before moving on. Neither gpu webhooks get nor gpu webhooks list will ever return it; if you lose it, delete the endpoint and register a new one.
--events accepts one of six event types (repeat the flag or pass a comma-separated list):
instance.creatinginstance.runninginstance.terminatedinstance.failedvideo.completedvideo.failed
all shortcut — subscriptions are explicit, so an endpoint never silently starts receiving event types added later.
gpu webhooks create [flags]
Examples
# Comma-separated list of event types
gpu webhooks create --url https://example.com/hooks/gpuai --events instance.running,instance.failed
# Same thing with a repeated flag
gpu webhooks create --url https://example.com/hooks/gpuai \
--events video.completed \
--events video.failed
Options
--events strings Event type to subscribe to (required; may repeat or be comma-separated). One of: instance.creating, instance.running, instance.terminated, instance.failed, video.completed, video.failed
-h, --help help for create
--url string HTTPS URL to deliver events to (required)
Options inherited from parent commands
--api-base string API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
--debug Enable debug logging to stderr
-o, --output string Output format: table|json (default table on TTY, json otherwise)
SEE ALSO
- gpu webhooks - Manage webhook endpoints