---
title: "Update a batch"
method: PUT
path: "/campaigns/batches/{id}"
tags: ["campaigns"]
---

# Update a batch

`PUT /campaigns/batches/{id}`

Updates a single Batch instance, currently batch can only be turned "on/off"

## Path parameters

- `id` integer, required

## Request body

- Batch — A batch represents a group of contacts which can be dialed or texted via call/text broadcast
  - `id` integer — A id of a batch
  - `name` string — A batch name
  - `status` 'NEW' | 'VALIDATING' | 'ERRORS' | 'SOURCE_ERROR' | 'ACTIVE' — A status of batch (NEW, VALIDATING, ERRORS, SOURCE_ERROR, ACTIVE). NEW - batch is queued for validation; VALIDATING - batch is currently validating; ERRORS - batch is processed, some validation errors occurred; SOURCE_ERROR - if contact source is contact list in CallFire system and it has an error; ACTIVE - batch is processed and ready
  - `broadcastId` integer — An id of broadcast which batch belongs to
  - `created` integer — A date and time when batch was created, formatted in unix time milliseconds. Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT
  - `size` integer — A total number of contacts in batch
  - `remaining` integer — A number of contacts remaining undialed/untexted
  - `enabled` boolean — An enabled batch. If batch is disabled its contacts remain undialed/untexted

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)