# Job Events

Alfred performs asynchronous document classification, extraction, and indexing on a variety of file types, from scanned images to digital documents. Each Job in Alfred encapsulates the complete workflow needed to process one or more files. The events detailed here offer insights into how a Job progresses, fails, retries, or completes its tasks, serving as crucial hooks for your application's business logic and event-driven architecture.

Whether you are integrating Alfred into a financial service application to process invoices, or into a healthcare system to categorize and index patient records, understanding these Job events will empower you to build more robust and responsive applications.

### Job Events List

<table data-header-hidden><thead><tr><th width="265.5">Event Name</th><th>Job Events</th></tr></thead><tbody><tr><td><strong>Event Name</strong></td><td><strong>Job Events</strong></td></tr><tr><td> <a href="https://docs.tagshelf.dev/event-types/jobevents/job-create">JobCreateEvent</a></td><td>Triggered when a new job is instantiated for file operations.</td></tr><tr><td> <a href="https://docs.tagshelf.dev/event-types/jobevents/job-exceeded-retries">JobExceededRetriesEvent</a></td><td>Fires when job exceeds maximum retry attempts for a stage.</td></tr><tr><td> <a href="https://docs.tagshelf.dev/event-types/jobevents/job-failed">JobFailedEvent</a></td><td>Occurs when a job halts due to an unrecoverable error.</td></tr><tr><td> <a href="https://docs.tagshelf.dev/event-types/jobevents/job-finished">JobFinishedEvent</a></td><td>Triggered when job successfully completes all workflow stages.</td></tr><tr><td> <a href="https://docs.tagshelf.dev/event-types/jobevents/job-invalid">JobInvalidEvent</a></td><td>Fires when job fails initial validation of input files or parameters.</td></tr><tr><td><a href="https://docs.tagshelf.dev/event-types/jobevents/job-retry"> JobRetryEvent</a></td><td>Triggered when job retries a stage after a recoverable failure.</td></tr><tr><td> <a href="https://docs.tagshelf.dev/event-types/jobevents/job-stage-update">JobStageUpdateEvent</a></td><td>Occurs when job transitions from one workflow stage to another.</td></tr><tr><td> <a href="https://docs.tagshelf.dev/event-types/jobevents/job-start">JobStartEvent</a></td><td>Triggered when job begins its workflow and state machine.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tagshelf.dev/event-api/jobevents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.