Patch Recipe Metadata

Partially update recipe metadata — rename, change country, or change demographic.

Send only the fields you want to change; omitted fields stay unchanged.

Side effect: Changing country or demographic clears computed nutrition data. Recalculate nutrition after the update.

The new name must be unique within the organization. All changes are logged in the audit trail.

The response carries version_id — the sealed Version ULID — which callers pass back as If-Match on the next mutation for optimistic concurrency. A mismatch returns 412 with the current version_id so the client can refetch and retry.

Path Parameters

recipe_id*Recipe Id

Header Parameters

If-Match?|

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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?|

New recipe name. Must be unique within the organization.

country?|

Update the country. Clears computed nutrition — recalculate after changing. Currently only US (→ US_FDA) is supported; additional countries coming soon.

demographic?|

Update the demographic group for %DV calculations. Must be valid for the recipe's regulatory authority. Clears computed nutrition — recalculate after changing.

rationale?|

Reason for the change (stored in audit trail)

Response Body

`application/json`

curl -X PATCH "https://loading/studio/recipes/string" \  -H "Content-Type: application/json" \  -d '{    "name": "Updated Recipe Name"  }'

{
  "data": {
    "id": "string",
    "name": "string",
    "country": "US",
    "regulatory_authority": "US_FDA",
    "demographic": "adults_and_children_over_4",
    "status": "active",
    "created_at": "string",
    "updated_at": "string",
    "summary": {
      "ingredient_count": 0,
      "has_nutrition": true,
      "is_nutrition_current": true,
      "serving_count": 0,
      "has_nutrition_facts": true
    },
    "actions": {
      "can_modify": true,
      "can_archive": true,
      "can_delete": true
    }
  },
  "meta": {
    "version": "string",
    "request_id": "string",
    "timestamp": "string"
  },
  "version_id": "string"
}

Empty

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

409

412

422application/json

`application/json`

`application/json`