Errors
HTTP status codes and JSON error bodies. Additional fields may appear in future versions.
Clients should branch on status first, then read the JSON body. The error string is stable for programmatic display; localized copy belongs in your product layer.
400 — validation / bad request
{
"error": "Missing required fields"
}500 — server error
{
"error": "Internal server error"
}