Enum ApiError 

pub enum ApiError {
    Http {
        status: u16,
        message: String,
    },
    Auth {
        message: String,
    },
    RateLimit {
        retry_after: Option<u64>,
    },
    NotFound {
        resource: String,
        id: String,
    },
    Validation {
        field: Option<String>,
        message: String,
    },
    Network {
        message: String,
    },
}

API-specific errors from the Todoist API.

These represent errors returned by the API itself (not transport-level errors).

Variants

Http

HTTP-level error with status code (for unexpected status codes).

Fields

status: u16

HTTP status code

message: String

Error message from the response

Auth

Authentication failure (401 Unauthorized, 403 Forbidden).

Fields

message: String

Descriptive error message

RateLimit

Rate limit exceeded (429 Too Many Requests).

Fields

retry_after: Option<u64>

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

NotFound

Resource not found (404 Not Found).

Fields

resource: String

Type of resource (e.g., “task”, “project”)

id: String

ID of the resource that was not found

Validation

API validation error (400 Bad Request with validation details).

Fields

field: Option<String>

Field that failed validation (if known)

message: String

Validation error message

Network

Network/connection error.

Fields

message: String

Descriptive error message

Implementations

impl ApiError

pub fn is_retryable(&self) -> bool

Returns true if this error is potentially retryable.

pub fn exit_code(&self) -> i32

Returns the appropriate CLI exit code for this error.

pub fn is_invalid_sync_token(&self) -> bool

Returns true if this error indicates an invalid sync token.

The Todoist API returns a 400 status code with a validation error when a sync token is invalid or expired. This method checks for common error messages that indicate sync token issues.

Trait Implementations

impl Clone for ApiError

fn clone(&self) -> ApiError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ApiError

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

Formats the value using the given formatter.

impl Display for ApiError

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

Formats the value using the given formatter.

impl Error for ApiError

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

fn from(source: ApiError) -> Self

Converts to this type from the input type.

impl PartialEq for ApiError

fn eq(&self, other: &ApiError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ApiError

impl StructuralPartialEq for ApiError