PaygateDeveloper documentation

Update Webhook Sink

PATCH/api/v1/test/webhooks/sinks/{id}
operationId
testkit.UpdateWebhookSink
Permission
simulate
Idempotency
required

An Idempotency-Key header is required.

Parameters

FieldinTypeRequiredDescription
idpathstringYes
Idempotency-KeyheaderstringYes
PG-Versionheaderstring

Request body

application/json

FieldTypeRequiredDescription
fail_countinteger
respond_statusinteger
sink_idstring

Example

Generated from the schema — a shape, not a sample.

{
  "fail_count": 0,
  "respond_status": 0,
  "sink_id": "string"
}

Responses

200 OK

WebhookSink

Response headers: `X-Request-Id`

FieldTypeRequiredDescription
created_atstring (date-time) (date-time)
fail_countinteger
idstring
modestring
namestring
received_countinteger
respond_statusinteger
updated_atstring (date-time) (date-time)
urlstring
{
  "created_at": "2026-10-01T09:00:00Z",
  "fail_count": 0,
  "id": "string",
  "mode": "string",
  "name": "string",
  "received_count": 0,
  "respond_status": 0,
  "updated_at": "2026-10-01T09:00:00Z",
  "url": "string"
}

default Error

Problem

FieldTypeRequiredDescription
codestringYes
detailstring
detailsobject
errorsobject[]
errors.codestring
errors.fieldstring
errors.messagestring
instancestring
statusintegerYes
titlestringYes
typestring
{
  "code": "string",
  "detail": "string",
  "details": {},
  "errors": [
    {
      "code": "string",
      "field": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "string"
}

Errors

Derived from the modules this operation touches, because the snapshot carries no x-errors list yet — it may list codes this operation cannot return.

Try it

PATCH/test/webhooks/sinks/%7Bid%7D

Makes a real call in test mode with your own key. The key stays in this tab and is never sent anywhere but the API.

No API base URL is configured for this environment, so try-it is unavailable.

Starts with pg_test_. A live key is refused before any request is made.

curl -X PATCH '<API_BASE_URL>/api/v1/test/webhooks/sinks/%7Bid%7D' \
  -H 'Authorization: Bearer pg_test_…' \
  -H 'PG-Version: 2026-09-01' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <uuid v7>' \
  -d '{
  "fail_count": 0,
  "respond_status": 0,
  "sink_id": "string"
}'