Merge pull request #6181 from segmentio/DOC-843

Updated rate limits response for HTTP API source [DOC-843]

Author: stayseesong

src/connections/sources/catalog/libraries/server/http-api/index.md

@@ -85,7 +85,9 @@ Segment welcomes feedback on API responses and error messages. [Reach out to sup
 
 ## Rate limits
 
-For each workspace, Segment recommends you to not exceed 1,000 requests per second with the HTTP API. If you exceed this, Segment reserves the right to queue any additional events and process those at a rate that doesn't exceed the limit. To request a higher limit, contact [Segment](mailto:[email protected]).
+For each workspace, Segment recommends you to not exceed 1,000 requests per second with the HTTP API. If you exceed this, Segment reserves the right to queue any additional events and process those at a rate that doesn't exceed the limit. Requests that exceed acceptable limits may be rejected with HTTP Status Code 429. When Segment rejects the requests, the response header contains `Retry-After` and `X-RateLimit-Reset` headers, which contains the number of seconds after which you can retry the request.
+
+To request a higher limit, contact [Segment](mailto:[email protected]).
 
 For [`batch` requests](#batch), there's a limit of 500 KB per request.