Kitchens

Kitchens represent physical locations where food is prepared, produced, or sold. Each kitchen can contain multiple recipes, products, and supplies.

Overview

Use the Kitchen API to:

• Create and manage restaurant locations
• Set up production facilities or retail stores
• Configure language preferences for each location
• Group recipes and supplies under locations for reporting

Licensing Requirement

Each kitchen must be licensed to calculate environmental impact data. Contact info@eaternity.ch to activate kitchens.

Kitchen Properties

Request/Response Schema

{
  "kitchen": {
    "name": "Kitchen Restaurant A",
    "location": "Zurich, Switzerland",
    "email": "kitchen-a@test-customer.com",
    "language": "en",
    "id": "kitchen-restaurant-a"
  }
}

Property Definitions

Property	Type	Required	Description
name	String	Yes	Official name of the kitchen or factory
location	String	Yes	Place where the kitchen is located. Address or country (arbitrary format).
email	String	No	Email address where reports are sent
language	String	No	Language of the reports for the kitchen
id	String	No	Kitchen identifier. Either generated by Eaternity or supplied by the client. Must be alphanumeric (dashes and underscores allowed).

Language Support

The language field controls the language used in:

• Recipe titles and descriptions
• Ingredient names
• Error messages
• Email notifications

Supported Languages

Code	Language
en	English
de	German
fr	French
it	Italian
es	Spanish

If no language is specified, the API defaults to English (en).

Error Responses

403 Forbidden

Kitchen not licensed:

{
  "error": "Forbidden",
  "message": "Kitchen 550e8400-e29b-41d4-a716-446655440000 is not licensed for environmental calculations",
  "status": 403
}

404 Not Found

Kitchen does not exist:

{
  "error": "Not Found",
  "message": "Kitchen with ID 550e8400-e29b-41d4-a716-446655440000 not found",
  "status": 404
}

Data Loss Warning

Deleting a kitchen permanently removes all associated recipes, products, supplies, and historical data. This action cannot be undone.

Endpoints

📄️ Create new kitchen

Creates a new kitchen. If the kitchen id is not provided, a new id is generated.

📄️ Get all kitchens

Returns a list of kitchen IDs belonging to this client (API key).

📄️ Get a kitchen

Retrieves the complete kitchen resource.

📄️ Create or update a kitchen

Update or create the kitchen with the specified ID.

📄️ Delete a kitchen

Deletes this kitchen from the server and also all data that is related to this kitchen.