Skip to content

Exceptions Reference

This page provides a reference for all common exceptions raised by Jobify.

  • Execution Errors

    Raised during task execution or when retrieving job results.

  • Scheduling Errors

    Raised when a job cannot be registered or updated.

  • State Errors

    Raised when operations are performed in an invalid application state.

  • Routing Errors

    Raised during task registration and router inclusion.

Execution Exceptions

These are raised when interacting with a Job object, typically via job.result() or job.wait().

Exception Description Attributes
JobFailedError Wrapped exception from a failed task. job_id, reason
JobTimeoutError Raised when execution exceeds timeout. job_id, timeout
JobNotCompletedError result() called while job is still active. job_id

Scheduling Exceptions

Raised by .push(), .at(), .delay(), or .cron() methods.

Exception Description Solution
DuplicateJobError Job ID already exists in storage. Use replace=True to update.

Application State Exceptions

Raised when calling methods at the wrong point in the application lifecycle.

Exception Description Common Scenarios
ApplicationStateError Invalid operation for current state. Registering tasks after startup; Scheduling before startup.

Routing Exceptions

Raised during the definition phase of your application.

Exception Description
RouteAlreadyRegisteredError Task name conflict within a router or app.