Confirm Ingredient Resolution Session
Confirms an ingredient resolution session and saves the resolved ingredients to the recipe, committing a new Version. By default, recipe-level nutrition is recomputed and folded into the same Version. If nutrition recompute fails, the whole call fails and no Version is cut. Pass ?compute=false to commit just the ingredient change without triggering nutrition recomputation.
Path Parameters
Session ID to confirm
Query Parameters
Auto-compute recipe-level nutrition + nutritional_analysis after confirming ingredients and fold the result into the same Version. Default true. Set false only when the caller wants to commit confirmed ingredients WITHOUT triggering nutrition recomputation (rare; bulk imports / batch sessions that recompute once at the end via POST .../nutrition/compute).
trueHeader 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 mismatch surfaces HTTP 412 with the current version_id in the response body so the client can decide whether to retry, merge, or surface the conflict to the user. Only consumed on API versions that declare the recipe_versioning capability — older versions ignore the header.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://loading/studio/recipes/string/ingredient-resolutions/string/confirm"{
"data": {
"recipe_id": "string",
"resolution_id": "string",
"ingredients": [
{
"original_text": "string",
"parsed_quantity": 0,
"parsed_unit": "string",
"parsed_ingredient_name": "string",
"selected_ingredient_id": "string",
"selected_ingredient_name": "string",
"metric_quantity_g": 0
}
],
"ingredient_conversions": [
{
"conversion_source": "string",
"reasoning": "string",
"portion_reference": {
"portion_bmid": "string",
"measure_unit_name": "string",
"gram_weight": "string",
"amount": "string"
}
}
],
"ingredient_resolutions": [
{
"original_text": "string",
"parsed": {
"quantity_text": "string",
"quantity": 0,
"unit": "string",
"ingredient_name": "string"
},
"converted": {
"quantity": 0,
"unit": "string",
"steps": [
{
"from_quantity": 0,
"from_unit": "string",
"to_quantity": 0,
"to_unit": "string",
"source": "string",
"reasoning": "string"
}
]
},
"matches": {
"query_text": "string",
"candidates": [
{
"ingredient_id": "string",
"ingredient_name": "string"
}
],
"selected_match": {
"ingredient_id": "string",
"ingredient_name": "string"
},
"match_confidence": 0,
"search_strategy_used": "standard"
}
}
],
"updated_at": "string"
},
"meta": {
"version": "string",
"request_id": "string",
"timestamp": "string"
},
"version_id": "string"
}{
"type": "https://api.bettermenu.com/errors/recipe_not_found",
"title": "Recipe Not Found",
"status": 400,
"detail": "Recipe rcpe_abc123 does not exist",
"code": "recipe_not_found",
"retryable": true,
"instance": "/api/v1/recipes/rcpe_abc123",
"trace_id": "req_xyz789",
"errors": [
{}
],
"invalid_ids": [
"f_abc123",
"f_xyz789"
]
}{
"type": "https://api.bettermenu.com/errors/recipe_not_found",
"title": "Recipe Not Found",
"status": 400,
"detail": "Recipe rcpe_abc123 does not exist",
"code": "recipe_not_found",
"retryable": true,
"instance": "/api/v1/recipes/rcpe_abc123",
"trace_id": "req_xyz789",
"errors": [
{}
],
"invalid_ids": [
"f_abc123",
"f_xyz789"
]
}{
"type": "https://api.bettermenu.com/errors/recipe_not_found",
"title": "Recipe Not Found",
"status": 400,
"detail": "Recipe rcpe_abc123 does not exist",
"code": "recipe_not_found",
"retryable": true,
"instance": "/api/v1/recipes/rcpe_abc123",
"trace_id": "req_xyz789",
"errors": [
{}
],
"invalid_ids": [
"f_abc123",
"f_xyz789"
]
}