---
title: "Create batch"
method: POST
path: "/v2/batches"
tags: ["batches"]
---

# Create batch

`POST /v2/batches`

Create a new batch.

<Note>[Upload files to the batch](/api-sdk/api-reference/batches/add-file-to-batch) in a separate request.</Note>

## Headers

- `Authorization` string, required
- `IB-Context` string

## Request body

- object
  - `name` string, required — Name of the batch. Maximum length is 255 characters.
  - `workspace` string — The name of the workspace in which to add the batch. If not specified, the default location is your personal workspace. When making this call from a service account, you must specify a workspace. <Info>For organization members, if the default drive changes but is still connected, you can still use the batch as input for running an app. However, you can't upload any additional files to the batch. If the default drive is disconnected, you can't use batches stored on that drive as input for any app run.</Info>

## Response `200`

Batch created successfully.

- Batch
  - `id` integer, required — Unique identifier for the batch.

---

[API](https://skmtc.net/instabase/apis/api-reference.md) · [All operations](https://skmtc.net/instabase/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instabase/api-reference/revisions/3a4f46d48141/schema)