gRPC: webhooks

Webhook subscriptions: events are delivered as JSON (CloudEvents 1.0 envelope) with an HMAC-SHA256 signature, retried with backoff, and parked in a dead-letter list after the last attempt.

`WebhookService`

Webhook subscriptions and their deliveries.

Method	Request	Response	Description
`CreateSubscription`	`CreateSubscriptionRequest`	`Subscription`	Creates a webhook subscription.
`ListSubscriptions`	`Empty`	`ListSubscriptionsResponse`	The webhook subscriptions.
`DeleteSubscription`	`DeleteSubscriptionRequest`	`Empty`	Deletes a subscription.
`TestSubscription`	`TestSubscriptionRequest`	`DeliveryResult`	Sends a synthetic event to the subscription and reports the outcome.
`ListDeadLetters`	`ListDeadLettersRequest`	`ListDeadLettersResponse`	Deliveries that failed (dead letters).

Messages

`Subscription`

A webhook subscription.

Field	Number	Type	Description
`id`	1	`string`	Id of the subscription.
`name`	2	`string`	Name.
`url`	3	`string`	HTTPS target the events are posted to.
`event_types`	4	repeated `string`	Event types to deliver (empty = all).
`labels`	5	repeated `string`	Free-form labels; alarms reference them in their actions.
`enabled`	6	`bool`	Deliveries are made.
`max_attempts`	7	`uint32`	Delivery attempts before an event becomes a dead letter.
`dead_letters`	8	`uint32`	Events that failed every attempt and are kept.
`delivered`	9	`uint64`	Events delivered.
`failed`	10	`uint64`	Delivery attempts that failed.
`tenant`	11	`string`	Tenant filter (tenant-N): only that tenant's self-service events.

`CreateSubscriptionRequest`

Creates a subscription.

Field	Number	Type	Description
`name`	1	`string`	Name.
`url`	2	`string`	HTTPS target.
`secret`	3	`string`	Shared secret for HMAC-SHA256; never returned.
`event_types`	4	repeated `string`	Event types to deliver; empty for all.
`labels`	5	repeated `string`	Labels of the subscription.
`max_attempts`	6	`uint32`	Delivery attempts before a dead letter; 0 for the default.
`tenant`	7	`string`	Deliver only the self-service events of this tenant (tenant-N; empty: all).

`ListSubscriptionsResponse`

The subscriptions.

Field	Number	Type	Description
`items`	1	repeated `Subscription`	Every subscription the caller can see.

`DeleteSubscriptionRequest`

Deletes a subscription.

Field	Number	Type	Description
`id`	1	`string`	Id of the subscription.

`TestSubscriptionRequest`

Sends a test event.

Field	Number	Type	Description
`id`	1	`string`	Id of the subscription.

`DeliveryResult`

Outcome of a delivery.

Field	Number	Type	Description
`delivered`	1	`bool`	The target accepted the event.
`status`	2	`uint32`	HTTP status the target answered; 0 without an answer.
`error`	3	`string`	Why the delivery failed; empty on success.
`attempts`	4	`uint32`	Attempts made.

`DeadLetter`

An event that failed every attempt.

Field	Number	Type	Description
`event_id`	1	`string`	Id of the event.
`attempts`	2	`uint32`	Attempts made.
`last_error`	3	`string`	Error of the last attempt.
`failed_at`	4	`string`	Time of the last attempt, RFC 3339.

`ListDeadLettersRequest`

Lists the dead letters of a subscription.

Field	Number	Type	Description
`id`	1	`string`	Id of the subscription.

`ListDeadLettersResponse`

The dead letters.

Field	Number	Type	Description
`items`	1	repeated `DeadLetter`	Dead letters of the subscription.