# Create a batch

Before you create jobs, you need to create a batch to put those jobs in.

A batch is a collection of jobs. We recommend using batches to group datasets you use internally, or to group jobs which are part of a weekly submission.

## A BATCH

<mark style="color:green;">`POST`</mark> `https://api.playment.io/v1/projects/:project_id/batch`

This endpoint allows you to create a batch

#### Path Parameters

| Name        | Type   | Description                                             |
| ----------- | ------ | ------------------------------------------------------- |
| project\_id | string | ID of the project in which you want to create the batch |

#### Headers

| Name      | Type   | Description                |
| --------- | ------ | -------------------------- |
| x-api-key | string | API key for authentication |

#### Request Body

| Name        | Type   | Description                                        |
| ----------- | ------ | -------------------------------------------------- |
| name        | string | Name of the batch                                  |
| description | string | Help others understand what this batch consists of |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "success": True,
    "data":{
        "batch_id": "c9970ee2-6979-46f1-95db-eee0176294a8"
    }
}
```

{% endtab %}
{% endtabs %}

The `batch_id` received in the response can be used to organize the jobs being created via the job creation API.

You can see the newly created batch inside the project in the GT Studio Jarvis dashboard.

![](https://1898243238-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MAyflu2a3TSnjJox7Sw%2F-MV-yZ8u5O2N9m3sJUSc%2F-MV007Nx5C3ahVeN6EBN%2Fimage.png?alt=media\&token=b21b4715-ac4f-4569-88c8-258b838aee77)