Title: ClientException::fromClientErrorResponse
Published: May 20, 2026

---

# ClientException::fromClientErrorResponse( WordPressAiClientProvidersHttpDTOResponse $response ): self

## In this article

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

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

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

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

This method extracts error details from common API response formats and creates 
an exception with a descriptive message and status code.

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

 `$response`WordPressAiClientProvidersHttpDTOResponserequired

The HTTP response that failed.

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-clientexception/fromclienterrorresponse/?output_format=md#return)󠁿

 self

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

    ```php
    public static function fromClientErrorResponse(Response $response): self
    {
        $statusCode = $response->getStatusCode();
        $statusTexts = [400 => 'Bad Request', 401 => 'Unauthorized', 403 => 'Forbidden', 404 => 'Not Found', 422 => 'Unprocessable Entity', 429 => 'Too Many Requests'];
        if (isset($statusTexts[$statusCode])) {
            $errorMessage = sprintf('%s (%d)', $statusTexts[$statusCode], $statusCode);
        } else {
            $errorMessage = sprintf('Client error (%d): Request was rejected due to client-side issue', $statusCode);
        }
        // Extract error message from response data using centralized utility
        $extractedError = ErrorMessageExtractor::extractFromResponseData($response->getData());
        if ($extractedError !== null) {
            $errorMessage .= ' - ' . $extractedError;
        }
        return new self($errorMessage, $statusCode);
    }
    ```

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

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

| Uses | Description | 
| [ErrorMessageExtractor::extractFromResponseData()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-errormessageextractor/extractfromresponsedata/)`wp-includes/php-ai-client/src/Providers/Http/Util/ErrorMessageExtractor.php` |

Extracts error message from API response data.

  |

| Used by | Description | 
| [ResponseUtil::throwIfNotSuccessful()](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-util-responseutil/throwifnotsuccessful/)`wp-includes/php-ai-client/src/Providers/Http/Util/ResponseUtil.php` |

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

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wordpress-aiclient-providers-http-exception-clientexception/fromclienterrorresponse/?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-clientexception%2Ffromclienterrorresponse%2F)
before being able to contribute a note or feedback.