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

# Create batch

`POST /v1/batches`

## Request

- Base URL: `https://api.neosantara.xyz`
- URL: `https://api.neosantara.xyz/v1/batches`
- Auth: HTTP bearer

Creates a new batch job for asynchronous processing.

## Response `200`

Batch created

- object
  - `id` string, required
  - `object` 'batch', required
  - `endpoint` string, required
  - `status` string, required
  - `created_at` number, required
  - `request_counts` object, required
    - `total` number, required
    - `completed` number, required
    - `failed` number, required

## Other responses

- `403`: Permission denied

---

[API](https://skmtc.dev/neosantara/apis/neosantara-ai-api.md) - [All operations](https://skmtc.dev/neosantara/apis/neosantara-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neosantara/apis/neosantara-ai-api/revisions/f87af696a63e?raw)