Dataset Batches

Batches are groups of images and labels that you can track across your annotation dashboard.

About

Once you upload your data into Roboflow, that data you uploaded turns into a batch. Batches are a group of images that you can track throughout the dataset process in Roboflow.

You can view all batches on the Annotate page of your project.

The view in the Annotate page. Note: The review column is not be available for Public users.

Once images are uploaded, they are in the Unassigned column.

You can assign a batch for someone to annotate, sending it to the Annotating column. You can also assign a selection of images in a batch. In this case, any unassigned images are moved into a new batch in Unassigned.

Once images in a batch are annotated, they are sent to Review (for users with Review Mode available) or to the Dataset column.

If batches are in the Review column, some or all are either approved or rejected. Approved batches will go into the Dataset column. Rejected batches are sent back to the Annotating column

Merging Batches

You can combine several batches into one from the Annotate page. This is useful when single-image approvals have split a correction set into many small batches.

Click the three dots next to a batch name and click "Merge Batches" to open the merge dialog. Search for and select two or more batches, then click the merge button. The selected batch with the most images survives and receives all the images from the others. The emptied batches disappear from the board.

Merging is only available on a batch that has at least one other compatible batch. Batches from different source videos cannot be merged together, and managed review queues cannot be merged.

Deleting a Batch

Deletions are permanent and irreversible. Roboflow cannot recover deleted batches.

You can only delete a batch in the Unassigned column. If the batch you want to delete is in the Annotating, Review or Dataset column, you will have to click Move to unassigned before clicking Delete Job.

You can delete batches by clicking on the three dots next to the batch name and clicking "Delete Batch".

HTTP API

You can get a list of the batches that your uploaded images are grouped into by making the following GET request:

curl --location --request GET 'https://api.roboflow.com/${WORKSPACE}/${PROJECT}/batches?api_key=${ROBOFLOW_API_KEY}'

This request will return a response in the following format:

{
    "batches": [
        {
            "name": "Uploaded on 11/22/22 at 1:39 pm",
            "numJobs": 2,
            "images": 115,
            "uploaded": {
                "_seconds": 1669146024,
                "_nanoseconds": 818000000
            },
            "id": "<BATCH_ID 1>"
        },
        {
            "numJobs": 0,
            "images": 11,
            "uploaded": {
                "_seconds": 1669236873,
                "_nanoseconds": 47000000
            },
            "name": "Upload via API",
            "id": "<BATCH_ID 2>"
        }
    ]
}

To get info for a specific Batch only, you can add the batch Id to the path of the request:

curl --location --request GET 'https://api.roboflow.com/${WORKSPACE}/${PROJECT}/batches/${BATCH_ID}?api_key=${ROBOFLOW_API_KEY}'

This request will return data in the following format:

{
    "name": "Uploaded on 11/22/22 at 1:39 pm",
    "uploaded": {
        "_seconds": 1669146024,
        "_nanoseconds": 818000000
    },
    "images": 115,
    "numJobs": 2,
    "id": "<BATCH_ID>"
}