PizzaStack API

Acquire a virtual tomato

post

Acquires a virtual tomato. Returns a tomato object with a unique ID and type "raw". Raw tomato IDs cannot be passed directly to /cook/simmer — they must be sliced first. See /tomato/slice.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

varietystring · enumRequiredPossible values:

ripenessnumber · max: 1Required

weightnumberRequired

Weight in grams

Responses

200

Tomato acquired

application/json

idstringOptional

varietystringOptional

ripenessnumberOptional

weightnumberOptional

typestring · enumOptionalPossible values:

propertiesobjectOptional

400

Invalid parameters

401

Missing or invalid API key

post

/tomato/acquire

POST /v1/tomato/acquire HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "variety": "San Marzano",
  "ripeness": 1,
  "weight": 1
}

{
  "id": "text",
  "variety": "text",
  "ripeness": 1,
  "weight": 1,
  "type": "raw",
  "properties": {}
}

Slice tomatoes

post

Slices one or more tomatoes. Returns a slice result object with type "sliced". Sliced IDs are accepted by /cook/simmer.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

tomato_idsstring[]Required

methodstring · enumRequiredPossible values:

sizestring · enumRequiredPossible values:

consistencystring · enumRequiredPossible values:

Responses

200

Sliced successfully

application/json

idstringOptional

source_tomato_idsstring[]Optional

methodstringOptional

sizestringOptional

consistencystringOptional

typestring · enumOptionalPossible values:

piecesobject[]Optional

400

Invalid parameters

401

Missing or invalid API key

post

/tomato/slice

POST /v1/tomato/slice HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "tomato_ids": [
    "text"
  ],
  "method": "dice",
  "size": "fine",
  "consistency": "uniform"
}

{
  "id": "text",
  "source_tomato_ids": [
    "text"
  ],
  "method": "text",
  "size": "text",
  "consistency": "text",
  "type": "sliced",
  "pieces": [
    {}
  ]
}

Extract juice from tomatoes

post

Extracts juice from raw or sliced tomatoes. Returns a juice object with type "juice". Juice IDs are also accepted by /cook/simmer.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

tomato_idsstring[]Required

pressurenumber · max: 1Required

Responses

200

Juice extracted

application/json

idstringOptional

volumenumberOptional

concentrationnumberOptional

typestring · enumOptionalPossible values:

propertiesobjectOptional

401

Missing or invalid API key

post

/tomato/squeeze

POST /v1/tomato/squeeze HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "tomato_ids": [
    "text"
  ],
  "pressure": 1
}

{
  "id": "text",
  "volume": 1,
  "concentration": 1,
  "type": "juice",
  "properties": {}
}

Simmer ingredients into sauce

post

Simmers ingredients into a tomato sauce.

Ingredient Requirements

The id field for each ingredient must reference an object of type "sliced" (from /tomato/slice) or type "juice" (from /tomato/squeeze). Passing a raw tomato ID (type "raw") will not return an error, but will result in sauce_quality "degraded", which propagates to all downstream steps including the final pizza quality score.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

temperaturenumberRequired

Temperature in Celsius

durationstringRequired

Duration string e.g. "30m", "1h"

stirring_frequencystring · enumOptionalPossible values:

Responses

200

Sauce created

application/json

idstringOptional

namestringOptional

sauce_qualitystring · enumOptionalPossible values:

degradation_reasonstringOptional

Present only when sauce_quality is "degraded"

ingredientsobject[]Optional

temperaturenumberOptional

durationstringOptional

propertiesobjectOptional

401

Missing or invalid API key

post

/cook/simmer

POST /v1/cook/simmer HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "ingredients": [
    {
      "id": "text",
      "name": "text",
      "amount": 1,
      "unit": "text"
    }
  ],
  "temperature": 1,
  "duration": "text",
  "stirring_frequency": "constant"
}

{
  "id": "text",
  "name": "text",
  "sauce_quality": "optimal",
  "degradation_reason": "text",
  "ingredients": [
    {}
  ],
  "temperature": 1,
  "duration": "text",
  "properties": {}
}

Roast ingredients

post

Roasts ingredients. Accepts any ingredient type.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

ingredientsobject[]Required

temperaturenumberRequired

durationstringRequired

turning_frequencystringOptional

Responses

200

Roasted successfully

No content

401

Missing or invalid API key

post

/cook/roast

POST /v1/cook/roast HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "ingredients": [
    {}
  ],
  "temperature": 1,
  "duration": "text",
  "turning_frequency": "text"
}

No content

Create a pizza base

post

Creates a pizza base. The returned ID is used in /pizza/assemble. Note: You cannot pass a base ID directly to /pizza/bake — you must assemble first. See /pizza/assemble.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

thicknessstring · enumRequiredPossible values:

sizestring · enumRequiredPossible values:

stylestring · enumRequiredPossible values:

hydrationnumber · max: 1Optional

fermentation_timestringOptional

flour_typestringOptional

salt_contentnumber · max: 1Optional

Responses

200

Base created

application/json

idstringOptional

thicknessstringOptional

sizestringOptional

stylestringOptional

hydrationnumberOptional

fermentation_timestringOptional

flour_typestringOptional

salt_contentnumberOptional

401

Missing or invalid API key

post

/pizza/base

POST /v1/pizza/base HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 134

{
  "thickness": "thin",
  "size": "8inch",
  "style": "neapolitan",
  "hydration": 1,
  "fermentation_time": "text",
  "flour_type": "text",
  "salt_content": 1
}

{
  "id": "text",
  "thickness": "text",
  "size": "text",
  "style": "text",
  "hydration": 1,
  "fermentation_time": "text",
  "flour_type": "text",
  "salt_content": 1
}

Assemble a pizza

post

Assembles a pizza from a base, sauce, and toppings. Returns an assembled pizza object whose ID is required by /pizza/bake.

Assembly Required

/pizza/bake requires a pizza_id from this endpoint. Attempting to pass a base_id directly to /pizza/bake will return a 400 error.

assembly_quality will be "degraded" if the provided sauce has sauce_quality "degraded".

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

base_idstringRequired

sauce_idstringRequired

ID from /cook/simmer or /cook/roast

Responses

200

Pizza assembled

application/json

idstringOptional

toppingsobject[]Optional

statusstring · enumOptionalPossible values:

assembly_qualitystring · enumOptionalPossible values:

400

Invalid base_id or sauce_id

401

Missing or invalid API key

post

/pizza/assemble

POST /v1/pizza/assemble HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "base_id": "text",
  "sauce_id": "text",
  "toppings": [
    {
      "name": "text",
      "amount": 1,
      "unit": "text",
      "distribution": "even"
    }
  ]
}

{
  "id": "text",
  "base": {
    "id": "text",
    "thickness": "text",
    "size": "text",
    "style": "text",
    "hydration": 1,
    "fermentation_time": "text",
    "flour_type": "text",
    "salt_content": 1
  },
  "sauce": {
    "id": "text",
    "name": "text",
    "sauce_quality": "optimal",
    "degradation_reason": "text",
    "ingredients": [
      {}
    ],
    "temperature": 1,
    "duration": "text",
    "properties": {}
  },
  "toppings": [
    {}
  ],
  "status": "assembled",
  "assembly_quality": "optimal"
}

Bake an assembled pizza

post

Bakes an assembled pizza. Requires a pizza_id from /pizza/assemble. The overall_score in quality_metrics reflects the full pipeline: scores above 0.85 indicate all preparation steps were correct; scores below 0.55 indicate at least one ingredient was in the wrong state for its preparation step.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

pizza_idstringRequired

ID from /pizza/assemble (not /pizza/base)

temperaturenumberRequired

Temperature in Celsius. Neapolitan typically 430–480.

durationstringRequired

rotation_frequencystringOptional

steam_injectionbooleanOptional

crust_developmentstring · enumOptionalPossible values:

Responses

200

Pizza baked

application/json

idstringOptional

pizza_idstringOptional

baking_parametersobjectOptional

400

pizza_id not found or not an assembled pizza

401

Missing or invalid API key

post

/pizza/bake

POST /v1/pizza/bake HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "pizza_id": "text",
  "temperature": 1,
  "duration": "text",
  "rotation_frequency": "text",
  "steam_injection": true,
  "crust_development": "low"
}

{
  "id": "text",
  "pizza_id": "text",
  "baking_parameters": {},
  "quality_metrics": {
    "overall_score": 1,
    "crust_crispness": 1,
    "cheese_melt": 1,
    "topping_distribution": 1,
    "sauce_integration": 1
  }
}

Analyze flavor profile

post

Analyzes the flavor profile of a baked pizza or sauce.

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

dish_idstringRequired

depthstring · enumOptionalPossible values:

include_aromabooleanOptional

include_texturebooleanOptional

Responses

200

Analysis complete

No content

401

Missing or invalid API key

post

/taste/analyze

POST /v1/taste/analyze HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "dish_id": "text",
  "depth": "basic",
  "include_aroma": true,
  "include_texture": true
}

No content

Compare multiple dishes

post

Authorizations

X-API-KeystringRequired

Header parameters

X-Session-IDstring · uuidRequired

UUID identifying your current session. Generate once per run.

Body

dish_idsstring[]Required

Responses

200

Comparison complete

No content

401

Missing or invalid API key

post

/taste/compare

POST /v1/taste/compare HTTP/1.1
Host: api.tomatopy.pizza
X-API-Key: YOUR_API_KEY
X-Session-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "dish_ids": [
    "text"
  ],
  "metrics": [
    "sweetness"
  ]
}

No content

Last updated 2 months ago

Was this helpful?