# Stop batch evaluation
<a name="batch-evaluations-stop"></a>

Stop a running batch evaluation job. The job transitions to `STOPPING` and then `STOPPED`. Partial results from sessions that were already evaluated may be available in the response.

Stopping a batch evaluation is useful when you realize the job was started with incorrect parameters, or when you no longer need the results.

## Code samples
<a name="stop-batch-eval-examples"></a>

**Example**  

```
agentcore stop batch-evaluation --id <batch-evaluation-id>
```

```
import boto3

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

response = client.stop_batch_evaluation(batchEvaluationId=batch_eval_id)
print(f"Status: {response['status']}")  # STOPPING or STOPPED
```

## Request parameters
<a name="stop-batch-eval-params"></a>


| Parameter | Type | Required | Description | 
| --- | --- | --- | --- | 
|  `batchEvaluationId`  | String | Yes | The batch evaluation ID to stop. Passed as a path parameter. | 

## Response
<a name="stop-batch-eval-response"></a>


| Field | Type | Description | 
| --- | --- | --- | 
|  `batchEvaluationId`  | String | The batch evaluation ID. | 
|  `batchEvaluationArn`  | String | ARN of the batch evaluation. | 
|  `status`  | String | Updated status: `STOPPING` or `STOPPED`. | 

## Errors
<a name="stop-batch-eval-errors"></a>


| Error | HTTP status | Description | 
| --- | --- | --- | 
|  `ResourceNotFoundException`  | 404 | No batch evaluation found with the specified ID. | 
|  `ConflictException`  | 409 | The batch evaluation is not in a state that can be stopped (for example, already completed or stopped). | 
|  `ValidationException`  | 400 | Invalid batch evaluation ID format. | 
|  `AccessDeniedException`  | 403 | Insufficient permissions. | 
|  `ThrottlingException`  | 429 | Request rate exceeded. | 
|  `InternalServerException`  | 500 | Service-side error. |