Endpoints

Update an endpoint

Change an endpoint's URL, headers, delivery settings, or active state.

PATCH/api/v1/endpoints/%7Bid%7D

cURL

curl -X PATCH "https://inboundr.net/api/v1/endpoints/{id}" \
  -H "Authorization: Bearer $INBOUNDR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<name>",
    "url": "<url>",
    "headers": {},
    "timeoutSeconds": 1,
    "maxAttempts": 1,
    "active": true
  }'

Updates any subset of an endpoint's settings. The signing secret can't be changed here. Provide at least one field.

idstringpathrequired

The endpoint id (ep_…).

namestringbody

Label (1–100 chars).

urlstringbody

The delivery URL (http or https). It must resolve to a public host and, for a Slack or Discord endpoint, be on that provider's incoming-webhook host.

headersobjectbody

Replaces the custom headers. Up to 10; reserved headers can't be overridden.

timeoutSecondsintegerbody

Per-request timeout, 1–30 seconds.

maxAttemptsintegerbody

Total attempts (first + retries), 1–10.

activebooleanbody

Whether the endpoint receives deliveries.

Example response

200

{
  "id": "ep_123",
  "name": "Production handler",
  "url": "https://api.example.com/hooks/v2",
  "headers": { "X-Team": "growth" },
  "timeoutSeconds": 15,
  "maxAttempts": 8,
  "active": true,
  "createdAt": "2026-07-20T10:00:00.000Z"
}

Returns 400 for an invalid URL, a private/internal host, or invalid headers; 404 if the endpoint isn't yours.