API Reference

Update a Webhook

Rename, pause, resume, or rotate a destination's credentials.

PATCH/webhooks/{id}

Parameters

Supply label, enabled, or a replacement URL. Rotate the URL separately from enabled changes. Register a new destination to change the webhook or thread ID. Valid credential replacement clears invalid status.

idpath UUID, required: Republic registration ID.
labelbody string: Name, 1 to 80 characters.
enabledbody boolean: false pauses new delivery; true resumes an eligible destination.
urlbody string: New token URL for the same webhook and thread. Include label.

Pause Delivery

cURL

curl -X PATCH 'https://dev.republicrx.app/api/developer/v1/webhooks/WEBHOOK_ID' \
  -H "Authorization: Bearer $REPUBLIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled":false}'

Rotate Credentials

cURL

curl -X PATCH 'https://dev.republicrx.app/api/developer/v1/webhooks/WEBHOOK_ID' \
  -H "Authorization: Bearer $REPUBLIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Newsroom","url":"REPLACEMENT_DISCORD_WEBHOOK_URL"}'

Response

HTTP 200. Pausing stops new deliveries but allows privacy cleanup of existing mirrors.

json

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000001"
  }
}