Title: ResponseUtil::throwIfNotSuccessful
Published: May 20, 2026

---

# ResponseUtil::throwIfNotSuccessful( WordPressAiClientProvidersHttpDTOResponse $response )

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#description)
 * [Parameters](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#wp--skip-link--target)

Throws an appropriate exception if the given response is not successful.

## 󠀁[Description](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#description)󠁿

This method checks the HTTP status code of the response and throws the appropriate
exception type based on the status code range:

 * 3xx: RedirectException (redirect responses)
 * 4xx: ClientException (client errors)
 * 5xx: ServerException (server errors)
 * Other unsuccessful responses: RuntimeException (invalid status codes)

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#parameters)󠁿

 `$response`WordPressAiClientProvidersHttpDTOResponserequired

The HTTP response to check.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#source)󠁿

    ```php
    public static function throwIfNotSuccessful(Response $response): void
    {
        if ($response->isSuccessful()) {
            return;
        }
        $statusCode = $response->getStatusCode();
        // 3xx Redirect Responses
        if ($statusCode >= 300 && $statusCode < 400) {
            throw RedirectException::fromRedirectResponse($response);
        }
        // 4xx Client Errors
        if ($statusCode >= 400 && $statusCode < 500) {
            throw ClientException::fromClientErrorResponse($response);
        }
        // 5xx Server Errors
        if ($statusCode >= 500 && $statusCode < 600) {
            throw ServerException::fromServerErrorResponse($response);
        }
        throw new \RuntimeException(sprintf('Response returned invalid status code: %s', $response->getStatusCode()));
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/php-ai-client/src/providers/http/util/responseutil.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/php-ai-client/src/Providers/Http/Util/ResponseUtil.php#L35)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/php-ai-client/src/Providers/Http/Util/ResponseUtil.php#L35-L54)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#related)󠁿

| Uses | Description | 
| [ServerException::fromServerErrorResponse()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-serverexception/fromservererrorresponse/)`wp-includes/php-ai-client/src/Providers/Http/Exception/ServerException.php` |

Creates a ServerException from a server error response.

  | 
| [RedirectException::fromRedirectResponse()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-redirectexception/fromredirectresponse/)`wp-includes/php-ai-client/src/Providers/Http/Exception/RedirectException.php` |

Creates a RedirectException from a redirect response.

  | 
| [ClientException::fromClientErrorResponse()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-clientexception/fromclienterrorresponse/)`wp-includes/php-ai-client/src/Providers/Http/Exception/ClientException.php` |

Creates a ClientException from a client error response (4xx).

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/?output_format=md#changelog)󠁿

| Version | Description | 
| [0.1.0](https://developer.wordpress.org/reference/since/0.1.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwordpress-aiclient-providers-http-util-responseutil%2Fthrowifnotsuccessful%2F)
before being able to contribute a note or feedback.