Skip to main content

Errors and retries

Errors use JSON:

{
"error": "Game is not connected to this workspace",
"code": "game_not_found"
}
StatusMeaningRetry?
400Invalid JSON or field validationNo; fix the request
401Missing, invalid, or revoked API keyNo; replace credentials
402Subscription inactive for new reportsNo; restriction checks still work
404Endpoint or connected game not foundNo; verify URL and game ID
413Request body too largeNo; minimize the payload
429Rate or monthly report limit reachedRetry only after the indicated operational limit resets
500-599Temporary Guardyn/provider failureYes, with bounded exponential backoff

Integrations should retry network errors, 429, and 5xx responses with a small capped backoff. Keep the same client_report_id while retrying a report.

Restriction checks must fail open after retries. Report submissions should tell the player Guardyn is unavailable and direct them to Roblox Report Abuse.