Knowledge Base
Job Lifecycle and States
Job Lifecycle and States
Understanding how jobs progress through states helps you monitor operations effectively in the Narrative Data Collaboration Platform.
Job States
Jobs progress through well-defined states:
| State | Description |
|---|---|
pending | Job is queued, waiting for resources |
running | Job is actively executing |
completed | Job finished successfully |
pending_cancellation | Job is being cancelled |
cancelled | Job was cancelled |
failed | Job encountered an error |
State Transitions
Normal Execution Flow
pending → running → completed
Cancellation Flow
pending → cancelled
running → pending_cancellation → cancelled
Error Flow
pending → running → failed
Final States
These states indicate a job has finished:
completed: Job finished successfully, results are availablefailed: Job encountered an error, check error detailscancelled: Job was cancelled, no results produced
Monitoring State Changes
You can monitor job state changes through:
- Webhook notifications: Real-time updates when states change
- API polling: Check job status programmatically
- Platform UI: View current job states in the dashboard
Related Topics
Job Types Reference
Learn about the different types of jobs available.