Enum ApiError 

pub enum ApiError {
    RunNotFound(Uuid),
    StepNotFound(Uuid),
    WorkflowNotFound(String),
    BadRequest(String),
    Conflict(String),
    Unauthorized,
    InvalidCredentials,
    DuplicateEmail,
    DuplicateUsername,
    ApiKeyNotFound(Uuid),
    UserNotFound(Uuid),
    Forbidden,
    SecretNotFound(String),
    InsufficientScope,
    IdempotencyKeyConflict(Uuid),
    MonthlyBudgetExceeded(String),
    ArtifactNotFound(String),
    ArtifactStorageUnavailable,
    ArtifactTooLarge,
    Store(StoreError),
    Internal(String),
}

Error type for REST API operations.

Maps to appropriate HTTP status codes and error codes in the JSON response.

Examples

use ironflow_api::error::ApiError;
use uuid::Uuid;

let err = ApiError::RunNotFound(Uuid::nil());
assert_eq!(err.to_string(), "run not found");

Variants

RunNotFound(Uuid)

The requested run does not exist (404).

StepNotFound(Uuid)

The requested step does not exist (404).

WorkflowNotFound(String)

Workflow not found (404).

BadRequest(String)

Bad request: invalid input (400).

Conflict(String)

The request conflicts with the current state of the resource (409).

Unauthorized

Authentication required (401).

InvalidCredentials

Invalid credentials (401).

DuplicateEmail

Email already taken (409).

DuplicateUsername

Username already taken (409).

ApiKeyNotFound(Uuid)

API key not found (404).

UserNotFound(Uuid)

User not found (404).

Forbidden

Insufficient permissions for this action (403).

SecretNotFound(String)

Secret not found (404).

InsufficientScope

Insufficient scope (403).

IdempotencyKeyConflict(Uuid)

The idempotency key is already bound to a different request (409).

Carries the run holding the key so the client can inspect it.

MonthlyBudgetExceeded(String)

The global monthly cost quota is exhausted (429).

Only blocks the creation of new runs; runs already in flight continue.

ArtifactNotFound(String)

The requested artifact does not exist (404).

ArtifactStorageUnavailable

No artifact storage backend is configured (501).

Every other endpoint keeps working: an upgraded deployment that has not opted into artifacts is degraded here only.

ArtifactTooLarge

The uploaded payload exceeded the artifact size limit (413).

Store(StoreError)

Store operation failed (500).

Internal(String)

Internal server error (500).

Trait Implementations

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

fn from(source: StoreError) -> Self

Converts to this type from the input type.

impl IntoResponse for ApiError

fn into_response(self) -> Response

Create a response.