Update a webhook endpoint

PATCH

/webhooks/endpoints/{endpointId}

Partial update: only fields present in the request body are
changed. At least one of url, eventTypes, enabled is required.

Setting enabled: true on a previously auto-disabled endpoint is
the ONLY way to re-enable it — a later successful delivery never
does this on its own — and clears the failure streak
(consecutiveFailures, disabledAt, disabledReason) as a fresh
start.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The updated endpoint.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://upload.tf/api/v1/webhooks/endpoints/' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "http://example.com",
    "eventTypes": [
        "page.published"
    ],
    "enabled": true
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "endpoint": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "url": "http://example.com",
            "eventTypes": [
                "page.published"
            ],
            "apiVersion": "2026-08-08",
            "enabled": true,
            "consecutiveFailures": 0,
            "lastSuccessAt": "2019-08-24T14:15:22.123Z",
            "lastFailureAt": "2019-08-24T14:15:22.123Z",
            "lastAttemptAt": "2019-08-24T14:15:22.123Z",
            "disabledAt": "2019-08-24T14:15:22.123Z",
            "disabledReason": "string",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z"
        }
    }
}

Modified at 2026-08-18 09:08:48

Get a webhook endpoint

Delete a webhook endpoint