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.creating
  • instance.running
  • instance.terminated
  • instance.failed
  • video.completed
  • video.failed
There is no 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

← The gpu CLI