v2

latestSwagger 2.02026-08-08121119168.6 KB

Webhooks

Update a webhook

Updates a webhook. Only the fields you send are changed. Sending auth_password or auth_token replaces the stored value; omitting them leaves it alone. The signing secret is not returned — rotate it if you have lost it.

put/v1/webhooks/{id}

Path parameters

idinteger required

Numeric webhook ID.

Request body

urlstring

Destination URL. Must be a public http(s) address.

namestring

Label for the webhook.

http_method'POST' | 'PUT' | 'PATCH'

HTTP method used to deliver.

failure_onlyboolean

Deliver only for failed tests.

alert_types'ALL' | 'VIRTUAL' | 'REAL'

Which grid to report on: ALL, VIRTUAL or REAL.

name_filterstring

Glob matched against the test name, falling back to the build identifier.

auth_type'NONE' | 'BASIC' | 'BEARER'

How to authenticate against your endpoint.

auth_usernamestring

Username for BASIC auth. Write-only.

auth_passwordstring

Password for BASIC auth. Write-only.

auth_tokenstring

Token for BEARER auth. Write-only.

headersstring[]

Custom request headers, each an object with key and value. Replaces the existing set.

paramsstring[]

Custom query parameters, each an object with key and value. Replaces the existing set.

payload_templatestring

Custom JSON body template. Send an empty string to go back to the default payload.

Response

Update a webhook

idinteger required

Unique numeric webhook ID.

namestring required

Label for the webhook, shown on the dashboard.

urlstring required

Destination URL. May contain {{VARIABLES}}, which are substituted at delivery time.

http_methodstring required

HTTP method used to deliver: POST, PUT or PATCH.

failure_onlyboolean required

When true, only failed tests trigger a delivery.

alert_typesstring required

Which grid the test ran on: ALL, VIRTUAL (VM) or REAL (physical device).

name_filterstring required

Glob matched against the test name, falling back to the build identifier. Empty means every test.

auth_typestring required

How the request authenticates against your endpoint: NONE, BASIC or BEARER. The credentials themselves are never returned.

headersobject[] required

Custom request headers, each { "key": ..., "value": ... }. Values support {{VARIABLES}}.

paramsobject[] required

Custom query parameters appended to the URL, each { "key": ..., "value": ... }.

payload_templatestring required

Custom JSON body template. Empty means the default TestingBot payload is sent.

created_atstring date-time required

When the webhook was created.

updated_atstring date-time required

When the webhook was last changed.

signing_secretstring required

Secret used to verify the X-TestingBot-Signature header. Only present when the webhook is created or its secret is rotated; store it then, because it is never returned again.