Error Reference
API Error Codes
Canonical error reference for GraphQL and REST responses.
This section is the canonical reference for API error documentation links generated by api.rad.live.
When the API includes documentation in an error payload, it points to:
https://developers.rad.live/docs/errors/<error_code_slug>Where <error_code_slug> is the lowercase enum code from the API (for example, GRAPHQL_VALIDATION_FAILED -> graphql_validation_failed).
Error response shape
GraphQL responses include machine-readable metadata in errors[].extensions:
{
"errors": [
{
"message": "Field 'channel' requires subfield selection",
"extensions": {
"code": "GRAPHQL_VALIDATION_FAILED",
"errorType": "ValidationError",
"field": "channel",
"suggestedFix": "Add subfields like: channel { id }",
"documentation": "https://developers.rad.live/docs/errors/graphql_validation_failed"
}
}
]
}REST responses use:
{
"errors": [
{
"message": "Invalid token",
"code": "UNAUTHENTICATED",
"documentation": "https://developers.rad.live/docs/errors/unauthenticated"
}
]
}