Enum Error 

pub enum Error {
    Http(Error),
    Json(Error),
    Api {
        status: u16,
        message: String,
        error_type: Option<String>,
    },
    RateLimit {
        retry_after: Option<u64>,
        message: String,
    },
    InvalidRequest(String),
    Authentication(String),
    Server {
        status: u16,
        message: String,
    },
    Network(String),
    StreamParse(String),
}

Main error type for Claude SDK operations.

This enum covers all possible error conditions when using the SDK. Use Error::is_retryable to check if an error can be retried.

Example

use claude_sdk::Error;

fn handle_error(err: Error) {
    if err.is_retryable() {
        println!("Can retry after {:?}s", err.retry_after());
    } else {
        println!("Fatal error: {}", err);
    }
}

Variants

Http(Error)

HTTP request failed.

This wraps errors from the underlying HTTP client (reqwest). May be retryable depending on the specific error.

Json(Error)

Failed to parse JSON response.

This typically indicates a bug or API contract change.

Api

API returned an error response.

Contains the HTTP status code and error message from the API. Check error_type for specific error categories like “invalid_request_error”.

Fields

status: u16

HTTP status code

message: String

Error message from the API

error_type: Option<String>

Error type (e.g., “invalid_request_error”, “authentication_error”)

RateLimit

Rate limit exceeded (HTTP 429).

The API has rate-limited your request. Check retry_after for the recommended wait time before retrying.

Fields

retry_after: Option<u64>

Seconds to wait before retrying (from Retry-After header)

message: String

Error message from the API

InvalidRequest(String)

Invalid request.

The request was malformed or missing required fields. This is not retryable - fix the request before trying again.

Authentication(String)

Authentication failed.

The API key is invalid, expired, or missing required permissions. Not retryable - verify your API key configuration.

Server

Server error (HTTP 5xx).

The API server encountered an internal error. These are typically transient and can be retried with exponential backoff.

Fields

status: u16

HTTP status code (500-599)

message: String

Error message

Network(String)

Network error.

Connection failed, timed out, or was interrupted. Usually retryable after a brief delay.

StreamParse(String)

SSE stream parsing error.

Failed to parse a server-sent event during streaming. May indicate a malformed response or connection issue.

Implementations

impl Error

pub fn is_retryable(&self) -> bool

Check if this error is retryable.

Returns true for transient errors that may succeed on retry:

• Rate limits (with backoff)
• Server errors (5xx)
• Network errors

Example

use claude_sdk::Error;

fn should_retry(err: &Error) -> bool {
    err.is_retryable()
}

pub fn retry_after(&self) -> Option<u64>

Get retry-after duration in seconds if available.

Only returns a value for Error::RateLimit errors that include a Retry-After header from the API.

Example

use claude_sdk::Error;
use std::time::Duration;

async fn wait_and_retry(err: &Error) {
    if let Some(seconds) = err.retry_after() {
        tokio::time::sleep(Duration::from_secs(seconds)).await;
    }
}

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.