### Code of Conduct - [X] I have read and agree to the GitHub Docs project's [Code of Conduct](https://github.com/github/docs/blob/main/CODE_OF_CONDUCT.md) ### What article on docs.github.com is affected? https://docs.github.com/en/graphql ### What part(s) of the article would you like to see updated? There seems to be no documentation for what the GraphQL API returns on error conditions. In particular, I can't find what error code to expect once the rate limit is exceeded. I see I can use the `rateLimit` query field to get information on how many points I have left _when a query succeeds_, but I can't rely on that alone as I might have a few points left and then make a very large request. I assume a rate limit error will also provide a `resetAt` field, but I have no idea under what name or path. The only way I can see to develop an app that will handle rate limits gracefully is to burn 5000 points and hit the error to learn how it looks like. ### Additional information _No response_ ---- _Maintainer update_ ## Proposed changes to fix this issue Expand the [Resource limitations](https://docs.github.com/en/graphql/overview/resource-limitations) article with examples of what happens if you exceed rate limits using the information from the comments below, in particular: - https://github.com/github/docs/issues/22607#issuecomment-1350193971 - https://github.com/github/docs/issues/22607#issuecomment-1350230101