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 account session token is missing, invalid, expired, revoked, or does not belong to the requested account or slot.
The referenced account or slot does not exist in the environment identified by the runtime key.
The submitted baseVersion is stale. Persistly returns local/cloud branches so the client can reconcile.
The slotInfo or data payload exceeds Persistly's documented byte limits.
The workspace has exhausted its monthly runtime request quota for the current plan.
The client exceeded allowed request volume for the current environment or plan.
The transfer code is malformed, unknown, revoked, or belongs to a different environment.
The transfer code has passed its short expiration window. Create a new code from the original device.
The transfer code was already used. Transfer codes are single-use.
Too many attempts were made against a real transfer code. Create a new code from the original device.
Transfer codes are not enabled for the current API deployment.
Persistly failed internally and the operation result should be treated as unknown.