CLcloudamqp
Webhooks

Update webhook

Update a specific webhook

put/webhooks/{id}

Request

  • Base URL
    https://api.cloudamqp.com/api
  • URL
    https://api.cloudamqp.com/api/webhooks/{id}
  • Auth
    HTTP basic

Request body application/x-www-form-urlencoded

namestring

Optional label for the webhook

webhook_uristring required

The URL to POST the messages to

queuestring required

The queue to consume from

vhoststring required

The vhost to connect to

concurrencyinteger required

Max simultaneous outstanding requests to the endpoint

timeoutinteger

The request timeout for webhook_uri

signing_secretstring

Optional secret key(s) for HMAC-SHA256 signature verification. When configured, webhook requests will include webhook-id, webhook-timestamp, and webhook-signature headers. Multiple secrets can be specified (space-separated) for zero-downtime key rotation.

Example request

{
  "name": "my-webhook",
  "webhook_uri": "https://your-endpoint.com/webhook",
  "queue": "your-queue",
  "vhost": "your-vhost",
  "concurrency": 10,
  "timeout": 30,
  "signing_secret": "my-secret-key-123"
}

Response

Webhook updated successfully

idinteger

Webhook ID

namestring nullable

Label for the webhook

webhook_uristring

Webhook endpoint URL

queuestring

Queue name

last_statusstring nullable

Last webhook status

concurrencyinteger

Max simultaneous outstanding requests

timeoutinteger

The request timeout for webhook_uri

signing_secretstring nullable

Secret key(s) for HMAC-SHA256 signature verification. When configured, webhook requests include webhook-id, webhook-timestamp, and webhook-signature headers. Multiple secrets can be specified (space-separated) for key rotation.

vhoststring

Virtual host name

Example response

{
  "id": 1,
  "name": "my-webhook",
  "webhook_uri": "http://www.example.com/endpoint",
  "queue": "push-queue",
  "concurrency": 10,
  "timeout": 30,
  "signing_secret": "my-secret-key-123",
  "vhost": "hptqevnp"
}

Changes

No recorded changes to this operation across all 8 revisions of this API.