`bird webhooks update`

Usage

Przykład kodu

bird webhooks update <webhook-id> [flags]

Change an endpoint's URL, description, subscribed event types, or delivery status. Only the fields sent change: events replaces the whole subscription set, and status pauses or re-enables delivery. Events fired while paused are not delivered.

Build the request from flags, a JSON WebhookEndpointUpdate body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

Przykład kodu

# print the body shape (no credentials needed)
bird webhooks update --example

# the body it prints:

Przykład kodu

{
  "description": "Updated webhook endpoint",
  "events": ["email.delivered", "email.bounced", "email.complained"],
  "status": "active",
  "url": "https://example.com/webhook"
}

Options

Request

Name	Description
`--body-file`	Read the JSON request body from this file; "-" reads stdin
`--example`	Print a complete example request body, then exit
`--dry-run`	Print the resolved request without sending it, then exit
`--idempotency-key`	Deduplication key; a retry with the same key won't act twice

Options

Name	Description
`--url`	Replacement delivery URL. Same rules as at creation: HTTPS, at most 2048 characters, and the host must be publicly reachable (private, loopback, and link-local addresses return a 422). Omit to keep the current URL. A connector endpoint's URL comes from its connector and cannot be replaced: any value returns a 422.
`--description`	Human-readable label for this endpoint, up to 256 characters.
`--events <v1,v2,…>`	Replaces all event subscriptions with this list. Omit to keep the current set. Types outside the event catalog return a 422. Known values: amb.accepted, amb.conversation_closed, amb.conversation_reopened, amb.conversation_started, amb.received, amb.rejected, amb.send_failed, amb.sent, amb_suppression.created, domain.failed, domain.verified, email.accepted, email.bounced, email.canceled, email.clicked, email.complained, email.deferred, email.delivered, email.list_unsubscribed, email.opened, email.out_of_band_bounce, email.processed, email.received, email.rejected, email.scheduled, email.unsubscribed, email_mailbox.message_delivered, email_mailbox.message_failed, email_mailbox.message_received, email_mailbox.message_sent, email_mailbox.suspended, email_mailbox.thread_created, email_suppression.created, preference.deleted, preference.granted, preference.revoked, sms.accepted, sms.delivered, sms.expired, sms.failed, sms.received, sms.rejected, sms.sent, sms.undelivered, sms_suppression.created, verify.attempt.delivered, verify.attempt.sent, verify.attempt.undelivered, verify.verification.created, verify.verification.failed, verify.verification.verified, voice_call.answered, voice_call.ended, voice_call.initiated, whatsapp.accepted, whatsapp.delivered, whatsapp.failed, whatsapp.group.join_request_created, whatsapp.group.join_request_revoked, whatsapp.reacted, whatsapp.read, whatsapp.received, whatsapp.rejected, whatsapp.sent, whatsapp_suppression.created (others may exist).
`--status`	paused stops all deliveries; active re-enables a paused endpoint. Omit to leave the status unchanged. Events that fire while paused are not delivered and a replay cannot recover them, because they were never attempted; after re-enabling, Replay failed deliveries reaches only the deliveries that failed before the pause. A degraded endpoint cannot be reset through this field: it returns to active automatically once deliveries succeed again. Possible values: active, paused.
`--response-schema`	Print the fields this command returns, then exit

Name	Description
`bird webhooks attempts`	List delivery attempts
`bird webhooks create`	Create a webhook endpoint
`bird webhooks delete`	Delete a webhook endpoint
`bird webhooks get`	Get a webhook endpoint
`bird webhooks list`	List webhook endpoints
`bird webhooks replay`	Replay failed deliveries
`bird webhooks rotate-secret`	Rotate webhook signing secret
`bird webhooks test`	Test a webhook with a sample event

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy

Powiązane zasoby