> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.hollr.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.hollr.ai/_mcp/server.

# Batches

Batches let you manage multiple calls as a single calling job.

## Create a batch

```text
POST /v1/call/create-batch
```

Creates a new batch of calls.

```bash
curl -X POST https://api.hollr.ai/v1/call/create-batch \
  -H "hollr-api-key: $HOLLR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "...": "..."
  }'
```

The exact request fields are not documented here because the supplied route definition does not expose the controller's request schema.

## List batches

```text
GET /v1/call/batches
```

```bash
curl https://api.hollr.ai/v1/call/batches \
  -H "hollr-api-key: $HOLLR_API_KEY"
```

## Get a batch

```text
GET /v1/call/batches/{batch_id}
```

```bash
curl https://api.hollr.ai/v1/call/batches/BATCH_ID \
  -H "hollr-api-key: $HOLLR_API_KEY"
```

## Get batch status

```text
GET /v1/call/batches/{batch_id}/status
```

```bash
curl https://api.hollr.ai/v1/call/batches/BATCH_ID/status \
  -H "hollr-api-key: $HOLLR_API_KEY"
```

## Pause a batch

```text
POST /v1/call/batches/{batch_id}/pause
```

```bash
curl -X POST https://api.hollr.ai/v1/call/batches/BATCH_ID/pause \
  -H "hollr-api-key: $HOLLR_API_KEY"
```

## Resume a batch

```text
POST /v1/call/batches/{batch_id}/resume
```

```bash
curl -X POST https://api.hollr.ai/v1/call/batches/BATCH_ID/resume \
  -H "hollr-api-key: $HOLLR_API_KEY"
```

## Reschedule a batch

```text
POST /v1/call/batches/{batch_id}/reschedule
```

```bash
curl -X POST https://api.hollr.ai/v1/call/batches/BATCH_ID/reschedule \
  -H "hollr-api-key: $HOLLR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "...": "..."
  }'
```

The exact request fields are not documented here because the supplied route definition does not expose the controller's request schema.

## Update a batch

```text
PATCH /v1/call/batches/{batch_id}
```

```bash
curl -X PATCH https://api.hollr.ai/v1/call/batches/BATCH_ID \
  -H "hollr-api-key: $HOLLR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "...": "..."
  }'
```

The exact request fields are not documented here because the supplied route definition does not expose the controller's request schema.

## Delete a batch

```text
DELETE /v1/call/batches/{batch_id}
```

```bash
curl -X DELETE https://api.hollr.ai/v1/call/batches/BATCH_ID \
  -H "hollr-api-key: $HOLLR_API_KEY"
```

## Authentication

All batch endpoints require the `hollr-api-key` header.

The supplied route definitions show request rate limiting on `create-batch`, `pause`, `resume`, and `reschedule`. See [Errors and rate limits](/errors-and-rate-limits) for the API's documented limits.