Skip to content

Error Codes

Common HTTP response codes returned by Genesys Cloud APIs.

Code Status Description Action
200 OK The request succeeded. None.
202 Accepted processing has started (e.g., Adherence Job). Poll the selfUri to check status.
400 Bad Request The server could not understand the request due to invalid syntax. Check your JSON body and parameters.
401 Unauthorized Authentication is required and has failed or has not been yet provided. Refresh your Bearer Token.
403 Forbidden The request was valid, but the server is refusing action. Check if the Client Credential has the required scopes/permissions.
404 Not Found The requested resource could not be found. Verify the ID (User ID, Team ID) or URL.
429 Too Many Requests The user has sent too many requests in a given amount of time. Implement exponential backoff. See Rate Limits.
503 Service Unavailable The server is not ready to handle the request. Retry after a short delay.