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.
Codes of Rudder
Section titled “Codes of Rudder”| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | The request is malformed: a bad body or header, a missing or too long Idempotency-Key on a mutation, a profile field out of range. |
| 400 | invalid_arguments | The arguments do not match the schema of the function. |
| 401 | invalid_key | The SDK key or server key is unknown or was replaced. |
| 401 | unauthorized | The token is missing, invalid or expired, or names a player the environment does not have. |
| 403 | player_banned | The player is banned. Only its client is refused. |
| 403 | player_deleted | The device signs in to a player an operator deleted. |
| 403 | forbidden | The role of the operator does not allow the action. |
| 404 | player_not_found | A 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. |
| 404 | module_not_found | The release has no such module. |
| 404 | function_not_found | The module has no such function, or it is marked server and a client called it. |
| 404 | identity_not_found | The player has no such linked account. |
| 409 | idempotency_key_reused | The player used this Idempotency-Key for another call. |
| 409 | identity_taken | The account is already attached to another player. |
| 409 | last_identity | The last linked account of a player cannot be unlinked. |
| 413 | invalid_request | The body is over 1 MB. |
| 422 | release_not_found | The environment has no release yet. |
| 429 | rate_limited | The project is over its request limit, or an operator registration or sign-in is limited. Wait for Retry-After seconds. |
| 500 | module_timeout | The module ran over the time of a call. Nothing changed. |
| 500 | internal | The module failed, or Rudder did. Nothing changed. |
| 503 | try_again | Rudder could not serve the request now. Nothing changed; send it again after Retry-After seconds, with the same Idempotency-Key. |
| 503 | module_unsupported | The 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.
Project configuration
Section titled “Project configuration”The CLI keeps these codes and the additional error fields when configuring a project.
| Status | Code | Action |
|---|---|---|
| 400 | invalid_cursor | Start the list again and retain its filters while following next. |
| 409 | cursor_expired | The draft changed. Read the first page again. |
| 409 | row_changed | Read and reconcile the current record returned in row before saving. |
| 409 | draft_changed | Read the updated draft and check it again before publication. |
| 409 | release_refused | Fix the reported problems and validate the draft again. |
| 422 | invalid_row | Correct the field named in the error. |
release check checks the whole draft and returns located problems, including those outside
the pages you read.
Codes of modules
Section titled “Codes of modules”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.
Codes of the client SDKs
Section titled “Codes of the client SDKs”invalid_response: the answer was not one of Rudder, such as an error page of a proxy.