On this page

API

webhook_url_forbidden

HTTP 422. Webhook URL forbidden

What it means

The URL fails the safety rules for webhook targets.

What to do

Use an https URL on a public DNS name, port 443 or 8443, without credentials. IP literals, localhost, .local, .internal and anything that resolves to a private address are refused. See webhooks.

Retrying

Do not retry the same request. Change it first.

Example

json
{
  "type": "https://reuseforge.com/docs/api/errors/webhook_url_forbidden",
  "title": "Webhook URL forbidden",
  "status": 422,
  "detail": "The host resolves to a private address.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "webhook_url_forbidden",
  "request_id": "req_c4v8n2m6x1z3"
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.