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

# Create a batch job

`POST /batches`

Create a new batch job with the given input file and endpoint

## Request body

- CreateBatchRequest
  - `endpoint` '/v1/chat/completions' | '/v1/audio/transcriptions' | '/v1/audio/translations', required — The endpoint to use for batch processing. Each line of the uploaded input file is dispatched against this endpoint. - `/v1/chat/completions` — chat completion batches - `/v1/audio/transcriptions` — audio transcription batches (e.g. `openai/whisper-large-v3`) - `/v1/audio/translations` — audio translation batches
  - `input_file_id` string, required — ID of the uploaded input file containing batch requests
  - `completion_window` string — Time window for batch completion (optional)
  - `priority` integer — Priority for batch processing (optional)
  - `model_id` string — Model to use for processing batch requests

## Response `201`

Job created (potentially with warnings)

- BatchJobWithWarning
  - `job` BatchJob
    - `id` string, uuid
    - `user_id` string
    - `input_file_id` string
    - `file_size_bytes` integer — Size of input file in bytes
    - `status` 'VALIDATING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'EXPIRED' | 'CANCELLED' — Current status of the batch job
    - `job_deadline` string, date-time
    - `created_at` string, date-time
    - `endpoint` string
    - `progress` number — Completion progress (0.0 to 100)
    - `model_id` string — Model used for processing requests
    - `output_file_id` string
    - `error_file_id` string
    - `error` string
    - `completed_at` string, date-time
  - `warning` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/1fab430e87d6/schema)