Skip to content

Error codes

Every refusal has the body:

{"error": {"code": "limit_reached", "message": "the player has bought the offer as many times as its limit allows"}}

Branch on code; message is for logs. A 500 carries a generic message.

StatusCodeMeaning
400invalid_requestThe request is malformed: a bad body or header, a missing or too long Idempotency-Key on a mutation, a profile field out of range.
400invalid_argumentsThe arguments do not match the schema of the function.
401invalid_keyThe SDK key or server key is unknown or was replaced.
401unauthorizedThe token is missing, invalid or expired, or names a player the environment does not have.
403player_bannedThe player is banned. Only its client is refused.
403player_deletedThe device signs in to a player an operator deleted.
403forbiddenThe role of the operator does not allow the action.
404player_not_foundA player that does not exist or was deleted, named by the game server or an operator, or called by a client whose token still names it.
404module_not_foundThe release has no such module.
404function_not_foundThe module has no such function, or it is marked server and a client called it.
404identity_not_foundThe player has no such linked account.
409idempotency_key_reusedThe player used this Idempotency-Key for another call.
409identity_takenThe account is already attached to another player.
409last_identityThe last linked account of a player cannot be unlinked.
413invalid_requestThe body is over 1 MB.
422release_not_foundThe environment has no release yet.
429rate_limitedThe project is over its request limit, or an operator registration or sign-in is limited. Wait for Retry-After seconds.
500module_timeoutThe module ran over the time of a call. Nothing changed.
500internalThe module failed, or Rudder did. Nothing changed.
503try_againRudder could not serve the request now. Nothing changed; send it again after Retry-After seconds, with the same Idempotency-Key.
503module_unsupportedThe module was built for a newer platform than the one serving it.

Operator registration accepts at most 10 attempts per client address in 15 minutes from the first attempt. Further attempts do not extend that period. Registration also returns 429 rate_limited when the service is busy. In both cases, wait for the number of seconds in Retry-After before trying again.

The CLI keeps these codes and the additional error fields when configuring a project.

StatusCodeAction
400invalid_cursorStart the list again and retain its filters while following next.
409cursor_expiredThe draft changed. Read the first page again.
409row_changedRead and reconcile the current record returned in row before saving.
409draft_changedRead the updated draft and check it again before publication.
409release_refusedFix the reported problems and validate the draft again.
422invalid_rowCorrect the field named in the error.

release check checks the whole draft and returns located problems, including those outside the pages you read.

With 422, the code is one the called module declares, such as limit_reached or sold_out of Stores. insufficient means a balance or a counter was too low. Nothing the call wrote is kept.

invalid_response: the answer was not one of Rudder, such as an error page of a proxy.