Errors

Peer REST returns a consistent JSON error object. Clients should branch on HTTP status and error.code.

Error envelope

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid request body",
    "details": []
  }
}

• code — stable machine-readable string
• message — human-readable summary (safe to log; may omit sensitive payload)
• details — optional validation issues (e.g. Zod field errors)

Status meanings

Common codes