Foods

Manage food items within categories. Foods can have ingredients, a custom printer, and can be toggled available/unavailable.

Food Object

{
  "id": "clm9876543210",
  "name": "Pizza Margherita",
  "description": "Classic pizza with tomato and mozzarella",
  "price": 9.99,
  "categoryId": "clxyz123456789abcdef",
  "printerId": "clxyz987654321fedcba",
  "available": true,
  "category": {
    "id": "clxyz123456789abcdef",
    "name": "Pizzeria",
    "available": true,
    "position": 1
  },
  "ingredients": [
    { "id": "clm111", "name": "Mozzarella" },
    { "id": "clm222", "name": "Tomato Sauce" }
  ]
}

GET /v1/foods

Retrieve all food items with optional filtering.

Authentication: Bearer token

• Non-admin users: only available=true foods
• Admin users: all foods

Query Parameters

Example

GET /v1/foods?include=ingredients&available=true&category=Pizzeria&category=Grill

Response 200 OK

Returns an array of Food Objects.

GET /v1/foods/{id}

Retrieve a single food item by ID.

Authentication: Bearer token

Path Parameters

Query Parameters

Response 200 OK

Returns a Food Object.

Errors

POST /v1/foods

Create a new food item.

Authentication: Bearer token (admin)

Request Body

{
  "name": "Pizza Margherita",
  "description": "Classic pizza with tomato and mozzarella",
  "price": 9.99,
  "categoryId": "clxyz123456789abcdef",
  "printerId": "clxyz987654321fedcba",
  "available": true,
  "ingredients": [
    { "id": "clm1234567890" },
    { "id": "clm0987654321" }
  ]
}

Response 201 Created

Returns the created Food Object.

Errors

PUT /v1/foods/{id}

Update a food item (full replacement).

Authentication: Bearer token (admin)

Path Parameters

Request Body

Same as POST.

Response 200 OK

Returns the updated Food Object.

Errors

PATCH /v1/foods/{id}

Update the availability status (or printer) of a food item.

Authentication: Bearer token (admin)

Path Parameters

Request Body

{
  "available": false,
  "printerId": "clxyz987654321fedcba"
}

Response 200 OK

Returns the updated Food Object.

Errors

DELETE /v1/foods/{id}

Delete a food item.

Authentication: Bearer token (admin)

Path Parameters

Response 204 No Content

Errors