Create Recipe

Create a new recipe in ACTIVE state. Only name is required. Country defaults to US. Demographic defaults to adults_and_children_over_4.

AGENT QUOTA PROTOCOL:

Call getEntitlementStatus; read quotas.recipes_per_month. If key absent, plan is unlimited — proceed directly.
If remaining > 0: proceed directly.
If remaining == 0: cost = overage_per_unit_cents / 100 (from status response). Inform user and ask for confirmation.
On approval: retry with metered_usage_confirmed: true, same X-Request-ID if retrying the same request (e.g. after timeout).
On decline: do not retry.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*Name

Recipe name

Length1 <= length <= 255

country?Country

Country whose regulatory framework applies. Determines which regulatory authority and demographic groups are valid. Currently only US (→ US_FDA) is supported; additional countries coming soon.

Default"US"

demographic?FDADemographic

Demographic group for %DV (percent daily value) calculations. Must be valid for the country's regulatory authority. US_FDA demographics: adults_and_children_over_4 (default), infants_through_12_months, children_1_3_years, pregnant_and_lactating_women.

Default"adults_and_children_over_4"

Value in"adults_and_children_over_4" | "infants_through_12_months" | "children_1_3_years" | "pregnant_and_lactating_women"

metered_usage_confirmed?|

Metered usage confirmation. Omit on first call. When your monthly recipe limit is reached, the API returns 402 with metered_units=1 and total_cents. Retry with metered_usage_confirmed: true to proceed with the charge. Sending false returns 422.

Response Body

`application/json`

curl -X POST "https://api.bettermenu.live/studio/recipes" \  -H "Content-Type: application/json" \  -d '{    "name": "Chocolate Chip Cookies"  }'

{
  "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

Request Body

Response Body

201application/json

402

409

422

`application/json`