Webhook endpoints

Repoint a webhook endpoint

Points an existing endpoint at a new URL. PATCH rather than PUT because url is the only mutable field, so the body is a partial by construction. The signing secret is deliberately UNTOUCHED — moving hosts must not force a receiver to re-key; rotating is the explicit sibling call. Same URL policy and same duplicate rule as create; the plan cap is NOT re-checked, because an update never grows the set and an app already over a lowered cap must still be able to fix a wrong URL. A URL that actually CHANGES also resumes an auto-paused endpoint (pausedAt back to null) and restarts its 7-day clock — a new address is the usual fix for a dead one. An unknown id and another app's id both answer 404.

patch/api/v1/webhook-endpoints/{endpointId}

Request

  • Base URL: https://app.dodomain.io
  • URL: https://app.dodomain.io/api/v1/webhook-endpoints/{endpointId}
  • Auth: HTTP bearer

Path parameters

endpointIdstring required

The endpoint id from GET /api/v1/webhook-endpoints.

Headers

DoDomain-Teamstring

The id of the team this call acts on, from GET /api/v1/teams. Needed only when the credential can use more than one team (an OAuth connection granted several); a secret key has exactly one. A team the credential cannot use is refused 404 TEAM_NOT_FOUND — the same answer whether the team exists or not.

Request body

urlstring required

Response

Success.

appIdstring required
createdAtstring date-time required
idstring required
pausedAtstring date-time nullable required
urlstring required

Changes

No recorded changes to this operation across all 1 revision of this API.