Title: RedirectException
Published: May 20, 2026

---

# class RedirectException {}

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-redirectexception/?output_format=md#description)
 * [Methods](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-redirectexception/?output_format=md#methods)
 * [Source](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-redirectexception/?output_format=md#source)
 * [Changelog](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-redirectexception/?output_format=md#changelog)

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

Exception thrown for 3xx HTTP redirect responses.

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

This represents cases where the server indicates that the request should be retried
at a different location, but automatic redirect handling was not successful or not
enabled.

## 󠀁[Methods](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-redirectexception/?output_format=md#methods)󠁿

| Name | Description | 
| [RedirectException::fromRedirectResponse](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-redirectexception/fromredirectresponse/) | Creates a RedirectException from a redirect response. |

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

    ```php
    class RedirectException extends RuntimeException
    {
        /**
         * Creates a RedirectException from a redirect response.
         *
         * This method extracts redirect information from the response headers
         * and creates an exception with a descriptive message and status code.
         *
         * @since 0.2.0
         *
         * @param Response $response The HTTP redirect response.
         * @return self
         */
        public static function fromRedirectResponse(Response $response): self
        {
            $statusCode = $response->getStatusCode();
            $statusTexts = [300 => 'Multiple Choices', 301 => 'Moved Permanently', 302 => 'Found', 303 => 'See Other', 304 => 'Not Modified', 307 => 'Temporary Redirect', 308 => 'Permanent Redirect'];
            if (isset($statusTexts[$statusCode])) {
                $errorMessage = sprintf('%s (%d)', $statusTexts[$statusCode], $statusCode);
            } else {
                $errorMessage = sprintf('Redirect error (%d): Request needs to be retried at a different location', $statusCode);
            }
            // Try to extract the redirect location from headers
            $locationValues = $response->getHeader('Location');
            if ($locationValues !== null && !empty($locationValues)) {
                $location = $locationValues[0];
                $errorMessage .= ' - Location: ' . $location;
            }
            return new self($errorMessage, $statusCode);
        }
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/php-ai-client/src/providers/http/exception/redirectexception.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/php-ai-client/src/Providers/Http/Exception/RedirectException.php#L17)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/php-ai-client/src/Providers/Http/Exception/RedirectException.php#L17-L47)

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

| Version | Description | 
| [0.2.0](https://developer.wordpress.org/reference/since/0.2.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-exception-redirectexception%2F)
before being able to contribute a note or feedback.