> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Control batch job

> Pause, resume, or cancel a batch import job — via the gu1 batch import API for high-volume data loading, with examples for control batch job use cases.

## Endpoint

```
POST https://api.gu1.ai/batch-import/jobs/{jobId}/control
```

## Overview

Cooperative pause / resume / cancel for a single job. Permissions depend on **`kind`**.

## Authentication

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Path Parameters

| Parameter | Description    |
| --------- | -------------- |
| `jobId`   | Job identifier |

## Request Body

```json theme={null}
{
  "kind": "transaction_batch" | "user_event_batch" | "entity_batch" | "entity_automatic",
  "action": "pause" | "resume" | "cancel"
}
```

* **`transaction_batch`** → requires `transactions:create`
* **`user_event_batch`** → requires `events:create`
* **`entity_batch`** (or deprecated alias **`entity_automatic`**) → requires `entities:bulk_import`

See also: [Bulk imports overview](/en/api-reference/bulk-imports/overview).