Delete Custom Ingredient
Permanently delete a custom ingredient — irreversible via the API. restoreCustomIngredient is refused on a deleted ingredient (409 custom_ingredient_not_restorable), so no prior version can undo this. Scoped to draft, never-confirmed ingredients with zero recipe usage only: a typo'd or misnamed draft that was never confirmed and never composed into a recipe. Rejected once the ingredient has been confirmed (active), archived, or is already deleted — use archiveCustomIngredient to withdraw an ingredient that's ever been active. Rejected if any recipe pins this ingredient, even though a draft cannot normally acquire usage — check getCustomIngredientUsage first if unsure. Unlike deleteRecipe, the ingredient remains readable afterward with status=deleted — the record and every version before the delete are retained; what ends is any further use of the ingredient.
Path Parameters
Header Parameters
Optimistic-concurrency token. Pass the version_id returned by the previous mutation (or by GET /recipes/{id}/versions) so the server can reject the request when another writer has advanced the recipe in the meantime. A stale token (header present but HEAD has moved) surfaces HTTP 409 with the current version_id in the response body. An absent token on a versioned recipe surfaces HTTP 412. Only consumed on API versions that declare the recipe_versioning capability — older versions ignore the header.
Response Body
application/json
application/json
curl -X DELETE "https://api.bettermenu.live/studio/custom-ingredients/string" \ -H "If-Match: string"{
"data": {
"id": "stringstringstringstringst",
"org_id": "stringstringstringstrings",
"status": "draft",
"name": "string",
"entry_method": "form",
"notes": "string",
"reference_amount": "string",
"reference_unit": "string",
"household_measure": "string",
"reference_quantity_g": "string",
"density_g_per_ml": "string",
"nutrients": [
{
"id": "stringstringstringstringst",
"unit": "string",
"amount": "string",
"market_nutrients": {
"property1": {
"bmid": "string",
"nutrient_id": 0
},
"property2": {
"bmid": "string",
"nutrient_id": 0
}
}
}
],
"approved_markets": [
"US"
],
"brand": "string",
"manufacturer": "string",
"source_url": "string",
"attributes": [
{
"key": "string",
"type": "string",
"value": null,
"searchable": false
}
],
"artifacts": [
{
"key": "string",
"kind": "string",
"uploaded_at": "2019-08-24T14:15:22Z"
}
],
"ingredient_statement": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"meta": {
"version": "string",
"request_id": "string",
"timestamp": "string"
},
"version_id": "string"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}