floorplay-zeta.vercel.app

place_item

Place one catalog item by its center. Applies immediately; undo_last_action takes it back. and reports any violations plus the nearest clear position. Prefer suggest_positions for beds, desks, sofas, wardrobes and shelves. Positions within 15 cm of a wall are snapped flush and wall furniture is turned to face the room; the result reports snapped: true. Coordinates are integer centimeters. Origin is the top-left corner of the room; x grows to the right, y grows downward. Items are placed by their center. rotation is 0, 90, 180 or 270 degrees clockwise; at 0 the item front faces +y (the bottom wall). Call get_room first to learn dimensions, openings and current items.

Input schema

{
  "type": "object",
  "properties": {
    "catalogId": {
      "type": "string",
      "description": "Catalog id from get_catalog"
    },
    "x": {
      "type": "integer",
      "description": "Center x (cm)"
    },
    "y": {
      "type": "integer",
      "description": "Center y (cm)"
    },
    "rotation": {
      "type": "integer",
      "description": "Rotation in degrees clockwise",
      "enum": [
        0,
        90,
        180,
        270
      ]
    }
  },
  "required": [
    "catalogId",
    "x",
    "y"
  ]
}