# Create a batch

**POST** `/v2/batches`

Creates and executes a batch from an uploaded dataset of requests

Base URL: `https://api.cohere.com`

Tags: `/batches`

## Authorization

| Option | Scheme | Type | Sent as | Scopes |
| --- | --- | --- | --- | --- |
| Option 1 | `bearerAuth` | `http` | `Authorization: Bearer <token>` | — |

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Client-Name` | `string` | No | The name of the project that is making the request. |

## Request body

Required. Media type: `application/json`

Information about the batch. Must contain name, input_dataset_id, and
model. Output-only fields are ignored.

### Example request body

```json
{
  "input_dataset_id": "string",
  "model": "string",
  "name": "string"
}
```

## Responses

| Status | Description | Media type |
| --- | --- | --- |
| `200` | A successful response. | `application/json` |
| `400` | Bad Request | `application/json` |
| `401` | Unauthorized | `application/json` |
| `403` | Forbidden | `application/json` |
| `404` | Not Found | `application/json` |
| `500` | Internal Server Error | `application/json` |
| `503` | Status Service Unavailable | `application/json` |

### Example response: 200 — A successful response.

```json
{
  "batch": {
    "created_at": "2026-06-09T00:00:00Z",
    "creator_id": "string",
    "id": "string",
    "input_dataset_id": "string",
    "input_tokens": "string",
    "model": "string",
    "name": "string",
    "num_failed_records": 0,
    "num_records": 0,
    "num_successful_records": 0,
    "org_id": "string",
    "output_dataset_id": "string",
    "output_tokens": "string",
    "status": "BATCH_STATUS_UNSPECIFIED",
    "status_reason": "string",
    "updated_at": "2026-06-09T00:00:00Z"
  }
}
```

### Example response: 400 — Bad Request

```json
{
  "message": "string"
}
```

### Example response: 401 — Unauthorized

```json
{
  "message": "string"
}
```

### Example response: 403 — Forbidden

```json
{
  "message": "string"
}
```

### Example response: 404 — Not Found

```json
{
  "message": "string"
}
```

### Example response: 500 — Internal Server Error

```json
{
  "message": "string"
}
```

### Example response: 503 — Status Service Unavailable

```json
{
  "message": "string"
}
```

## Related pages

- [/audio/transcriptions](./tags/audio-transcriptions.md)
- [/batches](./tags/batches.md)
- [/connectors](./tags/connectors.md)
- [/datasets](./tags/datasets.md)
- [/embed-jobs](./tags/embed-jobs.md)
- [/finetuning](./tags/finetuning.md)
- [/models](./tags/models.md)
- [API Reference](../../api.md)
- [Authorize with oAuth](./oauthauthorize-connector.md)
- [Cancel a batch](./cancelbatch.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.