---
title: "POST /recipes/{name}/batchDeleteRecipeVersion"
method: POST
path: "/recipes/{name}/batchDeleteRecipeVersion"
---

# POST /recipes/{name}/batchDeleteRecipeVersion

`POST /recipes/{name}/batchDeleteRecipeVersion`

Deletes one or more versions of a recipe at a time.

The entire request will be rejected if:

*   The recipe does not exist.
    
*   There is an invalid version identifier in the list of versions.
    
*   The version list is empty.
    
*   The version list size exceeds 50.
    
*   The version list contains duplicate entries.
    

The request will complete successfully, but with partial failures, if:

*   A version does not exist.
    
*   A version is being used by a job.
    
*   You specify `LATEST_WORKING`, but it's being used by a project.
    
*   The version fails to be deleted.
    

The `LATEST_WORKING` version will only be deleted if the recipe has no other versions. If you try to delete `LATEST_WORKING` while other versions exist (or if they can't be deleted), then `LATEST_WORKING` will be listed as partial failure in the response.

## Path parameters

- `name` string, required

## Request body

- object
  - `RecipeVersions` RecipeVersion[], required — An array of version identifiers, for the recipe versions to be deleted. You can specify numeric versions (<code>X.Y</code>) or <code>LATEST_WORKING</code>. <code>LATEST_PUBLISHED</code> is not supported.

## Response `200`

Success

- BatchDeleteRecipeVersionResponse
  - `Name` string, required — The name of the recipe that was modified.
  - `Errors` RecipeVersionErrorDetail[] — Errors, if any, that occurred while attempting to delete the recipe versions.
    - `ErrorCode` string — The HTTP status code for the error.
    - `ErrorMessage` string — The text of the error message.
    - `RecipeVersion` string — The identifier for the recipe version associated with this error.

## Other responses

- `480` — ConflictException
- `481` — ResourceNotFoundException
- `482` — ValidationException

---

[API](https://skmtc.net/aws/apis/databrew.md) · [All operations](https://skmtc.net/aws/apis/databrew/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/databrew/versions/c06b9719d66f/schema)