# Cancel a batch | Parsium Docs

Source: https://docs.parseium.com/api/operations/cancelbatch/

# Cancel a batch

POST

/v1/batches/{id}/cancel

Cancels pending jobs; running jobs finish. Workflow-stage batches must be canceled through their workflow run.

## Authorizations

 Section titled “Authorizations ”

- **[apiKeyHeader](/api/#apikeyheader)**
- **[apiKeyQuery](/api/#apikeyquery)**

## Parameters

 Section titled “
Parameters
”

### Path Parameters

 Section titled “Path Parameters ”

 id

required

 string

Batch ID

## Responses

 Section titled “
Responses
”

### 200

 Section titled “200 ”

Batch canceled.

 Select media type application/json

 object

 batch_id

 string

 state

 string

 jobs_canceled

 integer

### 401

 Section titled “401 ”

Missing or invalid API key.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

### 404

 Section titled “404 ”

Resource missing or not owned by this account.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

### 422

 Section titled “422 ”

Validation failed.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string