Middle-earth API

Errors

How the API reports problems.

1 MIN READ

The API uses standard HTTP status codes. Error responses share one shape.

Json
{
  "code": "you_shall_not_pass",
  "message": "token lacks the required scope",
  "request_id": "req_9a1"
}
StatusMeaning
401Missing or invalid token
403You shall not pass: your token lacks permission
404Not found. The thing may not want to be found
409A conflict, such as a member already in another fellowship
422Well formed but could not be processed
429Too many requests, for example a beacon lit twice in an hour

Quote the request_id when you contact support.