The request body, parameters, or payload shape is invalid for the runtime contract.
Error Codes
Persistly uses a small structured error vocabulary.
Exact error categories make SDK handling simpler and give coding agents stable patterns to generate around. Keep your game-specific messaging separate from the platform error code itself.
Error Schema
These error codes and HTTP statuses are the current public runtime set.
Persistly uses a small structured error vocabulary. Keep the numeric HTTP status visible and map your game-specific UX on top of the stable error code.
The runtime key is missing, malformed, revoked, or does not belong to the target environment.
The referenced saveId does not exist in the environment identified by the runtime key.
The submitted baseVersion is stale. Persistly returns the canonical current save so the client can reconcile.
The metadata or state payload exceeds Persistly's documented byte limits.
The client exceeded allowed request volume for the current environment or plan.
Persistly failed internally and the operation result should be treated as unknown.