POST /feedback
POST

/v1/feedback

Tell us an endpoint, field or parameter you needed and did not get, or a value that was wrong. Built for agents: point at the request with its X-Request-ID and pick a kind; there is no free-text field

AuthAPI key (your own, not a shared one)

Payload

POSThttps://api.xrpl.to/v1/feedback
Body
Body fieldsas documented
{
  kind: "missing_endpoint|missing_field|missing_param|wrong_value|null_field|stale_data|error|slow|docs_mismatch",
  requestId?: "X-Request-ID of the call (32 hex)",
  path?: "/v1/... when there is no requestId",
  method?: "GET|POST|PUT|PATCH|DELETE",
  name?: "the field or parameter (letters,
  digits,
  _; dotted for nesting)"
}
curl -X POST 'https://api.xrpl.to/v1/feedback' \
  -H 'X-Api-Key: YOUR_KEY'
Needs API key (your own, not a shared one) — copy the code and run it with your key.

Response

No public sample for this endpoint — run the code on the right with your own values and your key to see the response.
Shapeas documented
{
  success,
  took,
  received {
    kind,
    method,
    route,
    name,
    verified,
    status
  },
  reports
}

What it does

Tell us an endpoint, field or parameter you needed and did not get, or a value that was wrong. Built for agents: point at the request with its X-Request-ID and pick a kind; there is no free-text field

Notes
Every response carries X-Request-ID, and a 404 or 500 body carries a ready-made feedback block. With a requestId from your last 50 requests the method, route and status are read from our own log (verified: true); otherwise the path you send is used (verified: false). name is required for missing_field, missing_param, wrong_value and null_field, optional for stale_data and docs_mismatch, refused otherwise. Unknown fields are refused. Sending the same report again the same day adds to its count. Limits: 10 a minute, 50 different reports per wallet a day. A person reads the counts and decides; nothing is changed automatically
OpenAPI