📋 Error Codes Reference
Complete list of error codes used in mft-cloudsave API
Missing Parameters
1xxx
1001
MISSING_PARAM
One or more required parameters or headers are missing from the request
Validation Errors
2xxx
2001
INVALID_PARAM
Parameter or header value is invalid - failed type conversion or validation
2002
INVALID_SIGNATURE
HMAC signature verification failed - signature does not match expected value
Not Found Errors
3xxx
3001
DATA_NOT_FOUND
No data exists for the specified realm and user ID combination
Processing Errors
4xxx
4001
HANDSHAKE_FAILED
ECDH key exchange failed during handshake process
4002
SAVE_FAILED
Failed to save data to R2 storage - check storage availability
4003
RETRIEVE_FAILED
Failed to retrieve data from R2 storage - unexpected error occurred
4004
EMPTY_SAVE
Request body is empty - cannot save empty data
Method Errors
5xxx
5001
METHOD_NOT_ALLOWED
HTTP method is not allowed for this endpoint - check allowed methods
Authentication Errors
6xxx
6001
BEAM_AUTH_FAILED
Beamable authentication failed - invalid credentials or API secret
6002
BEAM_UID_MISMATCH
User ID in request does not match authenticated Beamable user