Enum HttpError 

pub enum HttpError {
    DeserializationError(Error<Error>),
    BadStatus {
        code: StatusCode,
        body: Value,
    },
    StreamError(Error),
    RequestError(Error),
    StreamingRequestError(CannotCloneRequestError),
    HttpError(Error),
    ApiError(ResponseError),
    WsConnect(Error),
    NotifySerialize(Error),
    NotifySend(Error),
    NotifyChannelClosed,
    NotifyRejected {
        code: u16,
        message: Value,
    },
}

Errors that can occur during HTTP operations.

Variants

DeserializationError(Error<Error>)

Failed to deserialize the response body.

Includes path information to help identify which field caused the error.

BadStatus

The server returned a non-success HTTP status code.

Fields

code: StatusCode

The HTTP status code (e.g., 400, 401, 500).

body: Value

Response body, parsed as JSON if possible, otherwise as a string.

StreamError(Error)

Error occurred while reading from an SSE stream.

RequestError(Error)

Failed to build the HTTP request.

StreamingRequestError(CannotCloneRequestError)

Failed to establish a streaming connection.

Occurs when the request cannot be cloned for SSE retry logic.

HttpError(Error)

General HTTP transport error (network, timeout, etc.).

ApiError(ResponseError)

The API returned a structured error response.

WsConnect(Error)

Failed to upgrade the request to a WebSocket. Used by the send_streaming_ws path before any frames have flowed.

NotifySerialize(Error)

Failed to serialize the notify request body to JSON.

NotifySend(Error)

Failed to write the notify frame to the WebSocket sink.

NotifyChannelClosed

The WebSocket closed before the matching client_response arrived. Either the server hung up or the demux task exited.

NotifyRejected

The server replied to a notify with client_response::Error. The most common cause is the notify’s response_id not matching any agent completion this WS produced.

Fields

code: u16

message: Value

Trait Implementations

impl Debug for HttpError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for HttpError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for HttpError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<CannotCloneRequestError> for HttpError

fn from(source: CannotCloneRequestError) -> Self

Converts to this type from the input type.

impl From<Error<Error>> for HttpError

fn from(source: Error<Error>) -> Self

Converts to this type from the input type.

impl From<Error> for HttpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HttpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ResponseError> for HttpError

fn from(source: ResponseError) -> Self

Converts to this type from the input type.

impl StatusError for HttpError

fn status(&self) -> u16

Returns the HTTP status code associated with this error.

fn message(&self) -> Option<Value>

Returns the error message, if any.