> ## Documentation Index > Fetch the complete documentation index at: https://avala.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Sequence Statuses > Reference for sequence workflow states This reference documents the lifecycle of a sequence in Avala, including every possible status and the transitions between them. ## Overview A **sequence** in Avala represents a unit of data (a set of frames, a point cloud scan, or a group of images) that moves through a structured annotation workflow. Each sequence has a status that reflects its current position in the pipeline. The status system supports both 4D (3D point cloud + time) and 2D (image/video) annotation stages, as well as review and approval workflows. ## Status Reference | Status | Description | | ---------------------- | ------------------------------------------------------------------------- | | `unattempted` | Sequence has been ingested but no work has been initiated | | `pending` | Sequence is queued for assignment to a work batch | | `ready_for_annotation` | Sequence is assigned and available for an annotator to begin | | `labeling_4d` | 3D/4D annotation is actively in progress | | `review_4d` | 3D/4D annotations are submitted and awaiting review | | `ready_for_2d` | 4D stage is approved; sequence is ready for 2D annotation | | `labeling_2d` | 2D annotation is actively in progress | | `review_2d` | 2D annotations are submitted and awaiting review | | `final_review` | All annotation stages are complete; awaiting final quality check | | `rework_required` | Reviewer identified issues; sequence is sent back for correction | | `completed` | All annotations are approved and finalized | | `customer_approved` | Customer (external stakeholder) has reviewed and approved the deliverable | ## State Transition Diagram ``` ┌─────────────┐ │ unattempted │ └──────┬──────┘ │ ▼ ┌─────────────┐ │ pending │ └──────┬──────┘ │ ▼ ┌────────────────────────┐ │ ready_for_annotation │ └───────────┬────────────┘ │ ┌────────────┴────────────┐ │ │ (4D pipeline) (2D-only pipeline) │ │ ▼ │ ┌─────────────┐ │ │ labeling_4d │ │ └──────┬──────┘ │ │ │ ▼ │ ┌─────────────┐ │ │ review_4d │◄─┐ │ └──────┬──────┘ │ │ │ (rework) │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ ready_for_2d ├─┘ │ └──────┬───────┘ │ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ labeling_2d │ │ labeling_2d │ └──────┬──────┘ └──────┬──────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ review_2d │ │ review_2d │ └──────┬──────┘ └──────┬──────┘ │ │ └────────────┬────────────┘ │ ▼ ┌───────────────┐ │ final_review │◄──────────┐ └───────┬───────┘ │ │ │ ┌────────┴────────┐ │ │ │ │ ▼ ▼ │ ┌───────────┐ ┌────────────────┐ │ │ completed │ │ rework_required ├──┘ └─────┬─────┘ └────────────────┘ │ ▼ ┌──────────────────┐ │ customer_approved│ └──────────────────┘ ``` ## Status Details ### unattempted The initial status for all newly ingested sequences. Data has been uploaded and processed, but no annotation work has been planned or started. * **Triggered by**: Data ingestion or upload * **Next status**: `pending` (when added to a project or work batch) ### pending The sequence is recognized by the project and queued for assignment. It is waiting to be placed in a work batch or assigned to an annotator. * **Triggered by**: Adding the sequence to a project * **Next status**: `ready_for_annotation` (when assigned to a batch or annotator) ### ready\_for\_annotation The sequence is assigned and available for an annotator to pick up. It appears in the annotator's work queue. * **Triggered by**: Batch assignment or direct assignment * **Next status**: `labeling_4d` (for datasets with 3D data) or `labeling_2d` (for 2D-only datasets) ### labeling\_4d An annotator is actively creating 3D/4D annotations (e.g., 3D cuboids in point clouds). The sequence is locked to the assigned annotator. * **Triggered by**: Annotator opens the sequence and begins 3D annotation * **Next status**: `review_4d` (when the annotator submits the work) ### review\_4d The 3D/4D annotations have been submitted and are awaiting review by a designated reviewer. * **Triggered by**: Annotator submits 3D annotations * **Next status**: `ready_for_2d` (if approved) or `labeling_4d` (if rejected and sent back for rework) ### ready\_for\_2d The 4D annotation stage is complete and approved. The sequence is now ready for 2D annotation work (e.g., annotating camera images using projected 3D cuboids as reference). * **Triggered by**: 4D review approval * **Next status**: `labeling_2d` (when an annotator begins 2D work) ### labeling\_2d An annotator is actively creating 2D annotations (e.g., bounding boxes, polygons, segmentation masks on camera images). The sequence is locked to the assigned annotator. * **Triggered by**: Annotator opens the sequence and begins 2D annotation * **Next status**: `review_2d` (when the annotator submits the work) ### review\_2d The 2D annotations have been submitted and are awaiting review. * **Triggered by**: Annotator submits 2D annotations * **Next status**: `final_review` (if approved) or `labeling_2d` (if rejected and sent back for rework) ### final\_review All annotation stages (4D and/or 2D) are complete. A senior reviewer or project manager performs a final quality check on the full set of annotations. * **Triggered by**: All preceding review stages are approved * **Next status**: `completed` (if approved) or `rework_required` (if issues are found) ### rework\_required The final reviewer identified quality issues that need correction. The sequence is routed back to the appropriate annotation stage for fixes. * **Triggered by**: Final reviewer rejects the sequence with feedback * **Next status**: `labeling_4d`, `labeling_2d`, or `final_review` (depending on which stage needs correction) ### completed All annotations are finalized and approved through every review stage. The sequence is ready for export or delivery. * **Triggered by**: Final review approval * **Next status**: `customer_approved` (when the customer confirms acceptance) ### customer\_approved The customer or external stakeholder has reviewed the delivered annotations and confirmed they meet acceptance criteria. This is the terminal status. * **Triggered by**: Customer approval action * **Next status**: None (terminal status) Not all statuses apply to every dataset. For 2D-only datasets (images, video without point clouds), the `labeling_4d`, `review_4d`, and `ready_for_2d` stages are skipped. Sequences move directly from `ready_for_annotation` to `labeling_2d`. ## Filtering by Status You can filter sequences by status throughout Avala: * **Sequence list**: Use the status filter dropdown to show sequences in specific states * **Smart views**: Create saved views filtered by status for quick access * **API**: Filter sequences by status in the `GET /sequences` endpoint * **Exports**: Export only sequences in `completed` or `customer_approved` status ## Status Counts The project dashboard displays a summary of sequences by status, giving you an at-a-glance view of pipeline throughput: | Metric | What It Shows | | --------------- | ---------------------------------------------------- | | **Backlog** | Sequences in `unattempted` + `pending` | | **In Progress** | Sequences in any `labeling_*` status | | **In Review** | Sequences in any `review_*` or `final_review` status | | **Rework** | Sequences in `rework_required` | | **Done** | Sequences in `completed` + `customer_approved` | ## Next Steps * Learn about [Quality Control](/docs/annotation/guides/quality-control) review workflows * Explore [Work Batches](/docs/annotation/guides/work-batches) for managing annotation assignments * See [Core Concepts](/docs/getting-started/concepts) for an overview of projects and sequences