Error Handling
How Errors Work
Biamo Core returns errors in a consistent JSON format to help you quickly identify and fix issues.
All error responses will have:
success: falsean
errorobject that includes:a human-readable
messagea machine-readable
code(for programmatic handling)
EVENTS
PROJECT
PROJECT
AUTH_001
Unauthorized. Invalid API key or missing project ID.
Your API key or project ID is missing or invalid.
VALIDATION_001
Invalid request body.
Your request payload is missing required fields or has invalid data.
NOT_FOUND
Resource not found.
The requested resource (API key, webhook, device) does not exist.
LIMIT_003
Maximum of 3 admins allowed per business.
You've reached the maximum number of admin users allowed.
CONFLICT_001
Resource already exists.
The resource you're trying to create already exists.
DUPLICATE_EMAIL
An admin with this email already exists.
The email you're trying to register is already in use.
SERVER_ERROR
Internal server error.
Something unexpected happened on our side. Please try again later.
RATE_LIMIT
Rate limit exceeded.
You have exceeded the maximum number of allowed API requests.
Example: Missing API Key
Request
Error Response
Example: Validation Error
Request
Error Response
How to Recover
Authorization errors → Double-check your
x-api-keyandx-project-idheaders.Validation errors → Review the API reference for required fields and correct data types.
Not found errors → Ensure you're using the correct resource IDs (e.g., API key ID, webhook ID).
Rate limit errors → Wait a short period and retry your request.
Conflict errors → Check if the resource already exists or update it instead of creating a new one.
Server errors → If the problem persists, contact Biamo Core Support.