Create A Recipe

This API available only for user access-token integration

POST	/v1/recipes

Endpoint allows building recipe from scratch.

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
collectionIds	array [string]	collection identifiers recipe should be added to
payload*	RecipePayload	recipe content

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 instruction 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
recipe*	ManualRecipeDetails	Recipe details.

RawIngredient

ATTRIBUTE	TYPE	DESCRIPTION
text*	string
group	string

NormalizedIngredient

ATTRIBUTE	TYPE	DESCRIPTION
text*	string
group	string
analysis	RecipeIngredientAnalysis

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 the current user is the owner of the recipe
type	enum	Recipe type Possible values: manual, imported.

RecipeAuthor

ATTRIBUTE	TYPE	DESCRIPTION
name*	string
image	ImageContainer

Sample Request

curl -X POST "https://graph.whisk.com/v1/recipes" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Token Access-Token>" \
  -d '{
    "collectionIds": [
      "97f77cceca5d11e7ae7e42010a9a0035"
    ],
    "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 sauce",
    "ingredients": [
      {
        "text": "Pappardelle pasta"
      },
      {
        "text": "5 tomatoes"
      },
      {
        "text": "3tbs of olive oil"
      }
    ],
    "saved": {
      "value": true,
      "collectionIds": [
        "cd037513c9e149a1b707e85eab1fc7f6"
      ],
      "owner": true,
      "type": "manual"
    }
  },
  "status": "success"
}