# Delete recommendation
<a name="recommendations-delete"></a>

Delete a recommendation and its associated metadata. The recommendation must be in a terminal state (`COMPLETED` or `FAILED`) before it can be deleted.

Deleting a recommendation removes the record from `ListRecommendations`. It does not affect any configuration bundle versions that were created as part of the recommendation result.

## Code samples
<a name="delete-rec-examples"></a>

**Example**  

```
import boto3

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

response = client.delete_recommendation(
    recommendationId="MyPromptRec-Ab1Cd2Ef3G"
)
print(f"Deleted: {response['recommendationId']}")
print(f"Status: {response['status']}")
```

## Request parameters
<a name="delete-rec-params"></a>


| Parameter | Type | Required | Description | 
| --- | --- | --- | --- | 
|  `recommendationId`  | String | Yes | The recommendation ID to delete. Passed as a path parameter. | 

## Response
<a name="delete-rec-response"></a>


| Field | Type | Description | 
| --- | --- | --- | 
|  `recommendationId`  | String | The recommendation ID. | 
|  `status`  | String | Status of the deleted recommendation (`DELETING`). | 

## Errors
<a name="delete-rec-errors"></a>


| Error | HTTP status | Description | 
| --- | --- | --- | 
|  `ResourceNotFoundException`  | 404 | No recommendation found with the specified ID. | 
|  `ConflictException`  | 409 | The recommendation is still running (`PENDING` or `IN_PROGRESS`). Wait for it to complete or fail before deleting. | 
|  `ValidationException`  | 400 | Invalid recommendation ID format. | 
|  `AccessDeniedException`  | 403 | Insufficient permissions. | 
|  `ThrottlingException`  | 429 | Request rate exceeded. | 
|  `InternalServerException`  | 500 | Service-side error. |