Change the cook's own recipe or version. Use when the cook says "add more garlic to my version", "make mine private", "take it down" (unpublished: true; off Strega for everyone but them, reversible; a recipe others have cooked or saved can only come down this way), "use my photo for the cover", "undo that last change", or "I made it tonight, took about 50 minutes" (tested; ask for the time if they didn't say, never assume). Pass only what changes; ingredients or steps, if passed, are the complete new list. photo: only one the cook took, never generated, stock or found; even when asked, name the recipe and get a yes first. Before calling, show the cook the changed ingredients and steps and get a yes; never save silently. Every edit keeps a revision (restore_revision: n undoes edit n). Not the cook's? Use fork_recipe. recover_photo is recovery-only: discover with get_my_kitchen section pending_photos, show the selected photo, target and current-cover replacement consequence, then wait for explicit selection and confirmation. cook_confirmed is the model's assertion, not independent proof of consent; never auto-confirm. Copy the full observed version unchanged and combine recovery with no other edits.
View input schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The cook's recipe or version to change"
},
"recover_photo": {
"type": "object",
"properties": {
"photo_id": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"expected_actor": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Copy from discovery; an account consistency check, never authorization"
},
"version": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"revision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"cover": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"revision",
"cover"
],
"additionalProperties": false,
"description": "Exact observed version from pending_photos; copy every field unchanged, including cover (do not normalize its URL)"
},
"cook_confirmed": {
"type": "boolean",
"const": true,
"description": "The assistant asserts the cook explicitly selected this photo and confirmed replacing this target's cover after seeing the preview and consequence. This flag is not independent proof of consent; never infer or auto-fill consent."
}
},
"required": [
"photo_id",
"expected_actor",
"version",
"cook_confirmed"
],
"additionalProperties": false,
"description": "Recover an uploaded cover without another intake. Use only with slug; no other edits, uploads, restoration or publication. First discover with get_my_kitchen section pending_photos, show the selected preview, target and replacement consequence, and wait for the cook's explicit confirmation."
},
"restore_revision": {
"description": "Undo: put the recipe back to how it was before edit n (see get_recipe's revisions). Other fields you pass apply on top.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"visibility": {
"type": "string",
"enum": [
"public",
"private"
]
},
"show_counts": {
"description": "Whether the page shows \"cooked N times · shared N times\" once there are enough cooks (#46); default on. false hides them",
"type": "boolean"
},
"unpublished": {
"description": "true takes the recipe off Strega for everyone but the cook (the link stays theirs, nothing is lost, their lists and plans still open it); false puts it back. Not an edit: no revision. Confirm first, like any change",
"type": "boolean"
},
"photo": {
"description": "A photo the cook took of this dish: the cover, or a step with step. Pass image_url or image_base64. Never a generated, stock or found-online picture. Asking for it isn't the yes: first tell the cook which recipe and where (\"I'll set this photo as the cover of <title>. OK?\") and call only after they say yes. It goes through Strega's photo check (a cover needs daylight and at least 1200 px on the long side); a refusal says what to fix and nothing changes. It replaces the current cover, a placeholder illustration included. If you can't pass the file, the cook can use \"Add a photo\" on the recipe page. Change publication status (unpublished) in a separate call, never together with a photo.",
"type": "object",
"properties": {
"image_url": {
"description": "A public https link to the cook's photo (a share link, or the host's download link for a file the cook attached)",
"type": "string",
"maxLength": 2000
},
"image_base64": {
"description": "The photo file itself as base64, for assistants that can read the cook's file: JPG, PNG, WebP or HEIC, up to 3 MB (bigger: pass image_url)",
"type": "string",
"maxLength": 4198400
},
"content_type": {
"description": "The file's type, e.g. image/jpeg; Strega reads it from the bytes",
"type": "string",
"maxLength": 40
},
"step": {
"description": "Put the photo on this step (1 is the first) instead of the cover",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 60
}
}
},
"attached_photo": {
"description": "A JPG, PNG or WebP photo the cook attached in the chat, for the cover (or a step with photo.step). Convert HEIC/HEIF to one of those formats first. Change publication status (unpublished) in a separate call, never together with a photo. ChatGPT fills in this file object when the cook attaches a picture; don't type a link here (a link goes in photo.image_url). The same rules as photo: only a photo the cook took of this dish; name the recipe and where it goes and get the cook's yes first; it goes through the photo check and replaces the current cover.",
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "The host's temporary download link for the attached file; the host fills this in"
},
"file_id": {
"type": "string",
"description": "The host's id for the file; the host fills this in"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"summary": {
"description": "One or two sentences on what makes it good",
"type": "string",
"maxLength": 400
},
"servings": {
"type": "number",
"minimum": 0.25,
"maximum": 1000
},
"yield_label": {
"description": "servings, cookies, loaves, jars…",
"type": "string",
"maxLength": 40
},
"prep_minutes": {
"type": "integer",
"minimum": 0,
"maximum": 2880
},
"cook_minutes": {
"type": "integer",
"minimum": 0,
"maximum": 2880
},
"tags": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 30
}
},
"seasons": {
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"spring",
"summer",
"fall",
"winter"
]
},
"description": "Explicit recipe labels only: spring, summer, fall, winter. [] means unknown. Do not infer from ingredients, dates, location or weather."
},
"author": {
"description": "Name to credit (the cook)",
"type": "string",
"maxLength": 80
},
"chef_note": {
"description": "The chef's note, up to 500 characters: a sentence or two in the cook's words on what makes the recipe theirs. Only what the cook said; never write one for them.",
"type": "string",
"maxLength": 500
},
"ingredients": {
"minItems": 1,
"maxItems": 80,
"type": "array",
"items": {
"type": "object",
"properties": {
"qty": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 100000
},
{
"type": "string",
"maxLength": 20
}
],
"description": "Amount, e.g. 1.5 or \"1 1/2\". Use 0 for 'to taste'."
},
"unit": {
"default": "",
"description": "tsp, tbsp, cup, fl oz, qt, oz, lb, g, kg, ml, l, clove, can, slice, sprig, bunch, head, stick, each, or empty",
"type": "string",
"maxLength": 20
},
"item": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Ingredient name, e.g. \"all-purpose flour\""
},
"note": {
"description": "Prep note, e.g. \"finely chopped\"",
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"key": {
"description": "Short tag steps use, e.g. \"flour\". When omitted: an ingredient already in the recipe keeps its key (match by item), a new one takes the tag your steps use for it if that tag is its name (\"nutritional_yeast\") or last word (\"yeast\"), else the last word of item.",
"anyOf": [
{
"type": "string",
"maxLength": 24,
"pattern": "^[a-z0-9_-]+$"
},
{
"type": "null"
}
]
}
},
"required": [
"qty",
"item"
]
}
},
"steps": {
"minItems": 1,
"maxItems": 60,
"type": "array",
"items": {
"type": "object",
"properties": {
"body": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"description": "Step text with amounts as tags: {flour}, a portion {butter:1/2}, oven temp in °F {t:375}"
},
"tip": {
"description": "A short pointer shown under the step, up to 140 characters: \"The batter should look lumpy; don't overmix.\"",
"anyOf": [
{
"type": "string",
"maxLength": 140
},
{
"type": "null"
}
]
},
"timer_minutes": {
"description": "Up to 24 hours (1440)",
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1440
},
{
"type": "null"
}
]
}
},
"required": [
"body"
]
}
},
"tested": {
"description": "Mark the recipe tested: the cook says they cooked it themselves and timed it. Ask the cook (\"Have you cooked this? About how long did it take, start to finish?\") and pass only what they say; never assume it, never estimate the minutes, and never mark a recipe tested because you drafted, imported or adapted it. null clears the mark. Shown as \"Tested by the cook · 45 min\" and counted as one timed cook.",
"anyOf": [
{
"type": "object",
"properties": {
"minutes": {
"type": "integer",
"minimum": 1,
"maximum": 2880,
"description": "How long it took, start to finish, in minutes"
}
},
"required": [
"minutes"
]
},
{
"type": "null"
}
]
}
},
"required": [
"slug"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}