RedRover Logo

Webhooks

Update a Webhook Endpoint

Changes an endpoint's URL, events or description, or turns it off or back on.

PATCH/webhooks/{id}
Scope: webhooks:write

Send only the fields to change. Turning an endpoint back on with enabled: true clears its failure count. Events from while it was off are not resent.

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Path Parameters

Body

  • urlstring

    Where we send events. Must be https and reach the public internet; private, loopback and cloud metadata addresses are refused

    up to 2048 characters

  • eventsstring[]

    The events to send, like post.posted. See Webhooks for the full list

    at least 1 items · each one of post.scheduled, post.posted, post.failed, post.needs_approval, post.cancelled, comment.scheduled, comment.posted, comment.failed, comment.needs_approval, comment.cancelled, review.note_added

  • descriptionstring

    Your own note, up to 200 characters. null clears it

    up to 200 characters · nullable

  • enabledboolean

    false to stop sending events, true to start again

Response

200 The endpoint after the change.

  • dataobjectRequired
    Show 9 Child Fields
    • idstringRequired

      Webhook endpoint ID (UUID)

    • workspaceIdstringRequired

      The workspace whose events it gets

    • urlstringRequired

      Where we send events. Always https

    • descriptionstringRequired

      Your note about the endpoint

      nullable

    • eventsstring[]Required

      The events it subscribes to

      each one of post.scheduled, post.posted, post.failed, post.needs_approval, post.cancelled, comment.scheduled, comment.posted, comment.failed, comment.needs_approval, comment.cancelled, review.note_added

    • enabledbooleanRequired

      False when turned off, by you or after repeated failures

    • disabledReasonstringRequired

      Why we turned the endpoint off, when we did

      nullable

    • createdAtstringRequired

      ISO 8601 datetime

    • updatedAtstringRequired

      ISO 8601 datetime

Errors

Every error uses the error envelope.

  • 400url is not https, cannot be found, or points to a private address
  • 404No webhook endpoint with this ID in the workspace
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something went wrong on our side
curl -X PATCH "https://app.tryredrover.com/api/public/v1/webhooks/5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": true
}'
200 Response
{
  "data": {
    "id": "5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93",
    "workspaceId": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
    "url": "https://example.com/hooks/redrover",
    "description": "Post updates to our team channel",
    "events": [
      "post.posted",
      "post.failed",
      "comment.posted"
    ],
    "enabled": true,
    "disabledReason": null,
    "createdAt": "2026-11-15T10:00:00Z",
    "updatedAt": "2026-11-15T10:00:00Z"
  }
}