Skip to main content
Vault returns errors as JSON with success: false and a message field. Use the HTTP status code and message to decide whether to retry, fix the request, or prompt the user.

​
Response format

{
  "success": false,
  "message": "Human-readable error message",
  "data": null
}

​
Reference

PageContent
HTTP status codesAll status codes and typical causes
Common errorsFrequent messages and how to fix them

​
Quick reference

CodeMeaning
400Bad Request — fix input
401Unauthorized — check API key or JWT
403Forbidden — permissions or MFA
404Not Found — resource doesn’t exist
409Conflict — duplicate or state conflict
429Too Many Requests — back off; use retry_after_seconds if present
5xxServer/upstream error — retry with backoff