Update External Recipe

This API available only for user access-token integration
PUT
/v1/:recipeId
Endpoint allows updating the recipe of any publisher.
The resulting recipe will be saved as a copy of the original recipe for the user.
The new recipe will have a different identifier. Please use it to continue working with the updated recipe.
Request parameters
ATTRIBUTE
TYPE
DESCRIPTION
fields
array [string]
Extra fields to return on the recipe Possible values: normalizedIngredients, instructions, nutrition.
Request Body
ATTRIBUTE
TYPE
DESCRIPTION
payload
RecipePayload
​
Recipe Payload
ATTRIBUTE
TYPE
DESCRIPTION
name*
string
recipe name
description
string
recipe description
ingredients
array [RawIngredient]
recipe ingredients
images
array [OriginalImage]
recipe images
instructions
RecipeInstructions
recipe instuction steps
durations
RecipeDurations
recipe cooking timing
source
ManualRecipeSource
source of the recipe, e.g. web site
servings
number
number of servings
Response
ATTRIBUTE
TYPE
DESCRIPTION
id*
string
​
name*
string
​
description
string
​
numberOfServings
number
The original number of servings
ingredients
array [RawIngredient]
​
normalizedIngredients
array [NormalizedIngredient]
​
instructions
RecipeInstructions
​
images
array [ImageContainer]
​
source
RecipeSource
​
durations
RecipeDurations
​
nutrition
RecipeNutrition
​
constraints
RecipeConstraints
​
saved
RecipeSaved
Information about collections
RawIngredient
ATTRIBUTE
TYPE
DESCRIPTION
text*
string
​
group
string
​
NormalizedIngredient
ATTRIBUTE
TYPE
DESCRIPTION
text*
string
​
group
string
​
analysis
RecipeIngredientAnalysis
​
RawIngredient
ATTRIBUTE
TYPE
DESCRIPTION
text*
string
​
group
string
​
RecipeIngredientAnalysis
ATTRIBUTE
TYPE
DESCRIPTION
product*
string
​
canonicalName*
string
​
quantity
number
​
unit
string
​
multiplier
number
​
brand
string
​
comment
string
​
category
string
​
RecipeInstruction
ATTRIBUTE
TYPE
DESCRIPTION
text*
string
​
group
string
​
images
array [ImageContainer]
​
RecipeInstructions
ATTRIBUTE
TYPE
DESCRIPTION
steps*
array [RecipeInstruction]
​
ProductCategory
ATTRIBUTE
TYPE
DESCRIPTION
name*
string
​
ImageContainer
ATTRIBUTE
TYPE
DESCRIPTION
url*
string
original image url, depricated. Please use field original instead
original
OriginalImage
original image information, e.g. image url
responsive*
ResponsiveImage
​
ResponsiveImage
ATTRIBUTE
TYPE
DESCRIPTION
url*
string
Hosted url of an image
width*
integer
Image width
height*
integer
Image height
OriginalImage
ATTRIBUTE
TYPE
DESCRIPTION
url*
string
URL of the image
RecipeSource
ATTRIBUTE
TYPE
DESCRIPTION
name*
string
​
displayName
string
​
sourceRecipeUrl
string
​
license
string
​
image
ImageContainer
​
RecipeLabels
ATTRIBUTE
TYPE
DESCRIPTION
mealType*
array [RecipeLabel]
​
cuisine*
array [RecipeLabel]
​
category*
array [RecipeLabel]
​
RecipeLabel
Some RecipeLabel description
ATTRIBUTE
TYPE
DESCRIPTION
name*
string
​
displayName*
string
​
RecipeDurations
ATTRIBUTE
TYPE
DESCRIPTION
cookTime
number
Cooking time in minutes
prepTime
number
Preparation time in minutes
totalTime
number
Total time in minutes
RecipeConstraints
ATTRIBUTE
TYPE
DESCRIPTION
violates*
ConstraintsCollection
Constraints which are violated in a recipe
ConstraintsCollection
ATTRIBUTE
TYPE
DESCRIPTION
diets*
array
List of diets Possible values: lacto-vegetarian, ovo-vegetarian, ovo-lacto-vegetarian, pescatarian, vegan, vegetarian.
avoidances*
array
List of avoidances and intolerances Possible values: celery, crustacean, egg, fish, groundnut, milk, mollusc, mustard, sesame, soybean, sulphites, tree-nut, wheat.
RecipeSaved
ATTRIBUTE
TYPE
DESCRIPTION
value
boolean
True if this recipe is saved to favorites
collectionIds
array [string]
​
owner
boolean
If current user is owner of the recipe
type
enum
Recipe type Possible values: manual, imported.
RecipeAuthor
ATTRIBUTE
TYPE
DESCRIPTION
name*
string
​
image
ImageContainer
​
Sample Request
curl -X PUT "https://graph.whisk.com/v1/1070c26c320ce194efca97093e72517b4e7" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Token Access-Token>" \
  -d '{
    "payload": {
      "name": "Home made pasta",
      "description": "Pasta with tomato souce",
      "ingredients": [
        {
          "text": "Pappardelle pasta"
        },
        {
          "text": "5 tomatoes"
        },
        {
          "text": "3tbs of olive oil"
        }
      ]
    }
  }'
Sample Response
{
  "recipe": {
    "id": "1070c26c320ce194efca97093e72517b4e7",
    "name": "Home made pasta",
    "description": "Pasta with tomato souce",
    "ingredients": [
      {
        "text": "Pappardelle pasta"
      },
      {
        "text": "5 tomatoes"
      },
      {
        "text": "3tbs of olive oil"
      }
    ],
    "saved": {
      "value": true,
      "collectionIds": [
        "cd037513c9e149a1b707e85eab1fc7f6"
      ],
      "owner": true,
      "type": "manual"
    }
  },
  "status": "success"
}
Create A Recipe
Get All User Recipes
Last updated 8 months ago
ATTRIBUTE	TYPE	DESCRIPTION
fields	array [string]	Extra fields to return on the recipe Possible values: normalizedIngredients, instructions, nutrition.