Update a webhook endpoint

Request

Update a webhook endpoint — change its target URL, subscribed event types, or status. Only the fields provided in the request body are changed.

Security

ApiKeyAuth

Path

idstringrequired

Idempotency-Keystring, <= 255 characters

Optional opaque key (e.g. a UUID) to make this write safely retryable. A replay with the same key returns the original response instead of repeating the side effect.

Bodyapplication/jsonrequired

namestring, [ 1 .. 100 ] characters

urlstring, (starts_with)^https:\/\/.*

HTTPS URL; private/loopback/metadata hosts are rejected.

subscribedEventsArray of strings, non-empty

Items Enum:"loan.created""loan.status_changed""loan.funded""document.uploaded""document.signed"

statusstring

Enum:"active""paused""disabled"

curl -i -X PATCH \
  'https://api.pioneerft.com/api/public/v1/webhook-endpoints/{id}' \
  -H 'Authorization: Bearer <YOUR_API Key_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -d '{
    "name": "string",
    "url": "string",
    "subscribedEvents": [
      "loan.created"
    ],
    "status": "active"
  }'

Responses

Webhook endpoint updated

Bodyapplication/json

dataobject(PublicWebhookEndpoint)

Response

{
  "data": {
    "id": "string",
    "name": "string",
    "url": "string",
    "environment": "string",
    "status": "string",
    "subscribedEvents": [
      "string"
    ],
    "consecutiveFailures": 0,
    "lastSuccessAt": "string",
    "lastFailureAt": "string",
    "lastFailureReason": "string",
    "autoDisabledAt": "string",
    "createdAt": "string"
  }
}