Merge branch 'feature/mongodb-migration' of https://atlarge.ewi.tudelft.nl/gitlab/opendc/opendc into feature/mongodb-migration

5 files changed, 1023 insertions, 3846 deletions

diff --git a/mongodb/docker-compose.yml b/mongodb/docker-compose.yml
index 0253cd7d..aa54a74c 100644
--- a/mongodb/docker-compose.yml
+++ b/mongodb/docker-compose.yml
@@ -27,4 +27,4 @@ services:
 
 volumes:
     mongo-volume:
-        external: false
\ No newline at end of file
+        external: false
diff --git a/mongodb/mongo-init-opendc-db.sh b/mongodb/mongo-init-opendc-db.sh
index 38a8d85d..e7a787fe 100644
--- a/mongodb/mongo-init-opendc-db.sh
+++ b/mongodb/mongo-init-opendc-db.sh
@@ -4,20 +4,36 @@ echo 'Creating opendc user and db'
 
 mongo opendc --host localhost \
         --port 27017 \
-        -u $MONGO_INITDB_ROOT_USERNAME \
-        -p $MONGO_INITDB_ROOT_PASSWORD \
+        -u "$MONGO_INITDB_ROOT_USERNAME" \
+        -p "$MONGO_INITDB_ROOT_PASSWORD" \
         --authenticationDatabase admin \
         --eval "db.createUser({user: '$OPENDC_DB_USERNAME', pwd: '$OPENDC_DB_PASSWORD', roles:[{role:'dbOwner', db: '$OPENDC_DB'}]});"
-MONGO_ROOT_CMD="mongo $OPENDC_DB --host localhost --port 27017 -u $MONGO_INITDB_ROOT_USERNAME -p $MONGO_INITDB_ROOT_PASSWORD --authenticationDatabase admin"
 
-#echo 'Creating opendc db schema...'
 MONGO_CMD="mongo $OPENDC_DB -u $OPENDC_DB_USERNAME -p $OPENDC_DB_PASSWORD --authenticationDatabase $OPENDC_DB"
+
+echo 'Creating collections'
+
+$MONGO_CMD --eval 'db.createCollection("users");'
+$MONGO_CMD --eval 'db.createCollection("simulations");'
+$MONGO_CMD --eval 'db.createCollection("topologies");'
+$MONGO_CMD --eval 'db.createCollection("experiments");'
 $MONGO_CMD --eval 'db.createCollection("prefabs");'
 
+echo 'Loading test data'
+
+$MONGO_CMD --eval 'db.users.insertOne(
+    {
+        "googleId": "23483578932789231",
+        "email": "jorgos.andreadis@gmail.com",
+        "givenName": "Jorgos",
+        "familyName": "Andreadis",
+        "authorizations": []
+    });'
+
 $MONGO_CMD --eval 'db.prefabs.insertOne(
     {
         "type": "rack",
-        "name": "test_rack3",
+        "name": "testRack3",
         "size": 42,
         "depth": 42,
         "author": "Jacob Burley",
@@ -26,7 +42,7 @@ $MONGO_CMD --eval 'db.prefabs.insertOne(
             {
                 "type": "switch",
                 "ports": 48,
-                "power_draw": 150,
+                "powerDraw": 150,
                 "psus": 1,
                 "size": 1
             },
@@ -37,16 +53,16 @@ $MONGO_CMD --eval 'db.prefabs.insertOne(
                     {
                         "type": "mainboard",
                         "sockets": 1,
-                        "dimm_slots": 4,
+                        "dimmSlots": 4,
                         "nics": 1,
-                        "pcie_slots": 2,
+                        "pcieSlots": 2,
                         "children": [
                             {
                                 "type": "CPU",
                                 "coreCount": 4,
                                 "SMT": true,
-                                "base_clk": 3.5,
-                                "boost_clk": 3.9,
+                                "baseClk": 3.5,
+                                "boostClk": 3.9,
                                 "brand": "Intel",
                                 "SKU": "i7-3770K",
                                 "socket": "LGA1155",
@@ -82,7 +98,7 @@ $MONGO_CMD --eval 'db.prefabs.insertOne(
                                 "coreCount": 2304,
                                 "brand": "AMD",
                                 "technologies": "OpenCL",
-                                "pcie_gen": "3x16",
+                                "pcieGen": "3x16",
                                 "tdp": 169,
                                 "slots": 2
                             }
@@ -98,35 +114,9 @@ $MONGO_CMD --eval 'db.prefabs.insertOne(
                         "size": 2000,
                         "interface": "SATA",
                         "media": "flash",
-                        "form_factor": 2.5
+                        "formFactor": 2.5
                     }
                 ]
             }
         ]
     });'
-
-$MONGO_CMD --eval 'db.createCollection("topologies");'
-
-$MONGO_CMD --eval 'db.createCollection("users");'
-
-$MONGO_CMD --eval 'db.users.insertOne(
-    {
-        "google_id": "23483578932789231",
-        "email": "jorgos.andreadis@gmail.com",
-        "given_name": "Jorgos",
-        "family_name": "Andreadis",
-        "authorizations": [
-            {
-                "simulation_id": 1,
-                "authorization_level": "OWN"
-            },
-            {
-                "simulation_id": 2,
-                "authorization_level": "READ"
-            },
-            {
-                "simulation_id": 3,
-                "authorization_level": "READWRITE"
-            }
-        ]
-    });'
\ No newline at end of file
diff --git a/mongodb/mongo-init.js b/mongodb/mongo-init.js
deleted file mode 100644
index 562bda6f..00000000
--- a/mongodb/mongo-init.js
+++ /dev/null
@@ -1,67 +0,0 @@
-db.auth('root', 'rootpassword')
-
-let error = true
-
-db.createUser(
-  {
-      user: "admin",
-      pwd: "adminpassword",
-      roles: [
-          {
-              role: "readWrite",
-              db: "admin"
-          }
-      ]
-  }
-)
-
-db = db.getSiblingDB('opendc')
-
-db.createUser(
-        {
-            user: "opendc",
-            pwd: "opendcpassword",
-            roles: [
-                {
-                    role: "readWrite",
-                    db: "opendc"
-                }
-            ]
-        }
-);
-
-db.createCollection(users)
-db.createCollection(authorizations)
-db.createCollection(authorization_levels)
-db.createCollection(simulations)
-db.createCollection(experiments)
-db.createCollection(paths)
-db.createCollection(sections)
-db.createCollection(schedulers)
-db.createCollection(traces)
-db.createCollection(jobs)
-db.createCollection(tasks)
-db.createCollection(task_dependencies)
-db.createCollection(task_states)
-db.createCollection(machine_states)
-db.createCollection(datacenters)
-db.createCollection(rooms)
-db.createCollection(room_types)
-db.createCollection(tiles)
-db.createCollection(objects)
-db.createCollection(object_types)
-db.createCollection(allowed_objects)
-db.createCollection(psus)
-db.createCollection(cooling_items)
-db.createCollection(racks)
-db.createCollection(machines)
-db.createCollection(machine_tags)
-db.createCollection(failure_models)
-db.createCollection(cpus)
-db.createCollection(machine_cpus)
-db.createCollection(gpus)
-db.createCollection(machine_gpus)
-db.createCollection(memories)
-db.createCollection(machine_memories)
-db.createCollection(storages)
-db.createCollection(machine_storages)
\ No newline at end of file
diff --git a/opendc-api-spec.json b/opendc-api-spec.json
deleted file mode 100644
index 93a0207d..00000000
--- a/opendc-api-spec.json
+++ /dev/null
@@ -1,3740 +0,0 @@
-{
-  "swagger": "2.0",
-  "info": {
-    "version": "0.2.0",
-    "title": "OpenDC API",
-    "description": "OpenDC is an open-source datacenter simulator for education, featuring real-time online collaboration, diverse simulation models, and detailed performance feedback statistics."
-  },
-  "host": "opendc.ewi.tudelft.nl",
-  "basePath": "/v1",
-  "schemes": [
-    "https"
-  ],
-  "paths": {
-    "/users": {
-      "get": {
-        "tags": [
-          "users"
-        ],
-        "description": "Search for a User using their email address.",
-        "parameters": [
-          {
-            "name": "email",
-            "in": "query",
-            "description": "User's email address.",
-            "required": true,
-            "type": "string"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully searched Users.",
-            "schema": {
-              "$ref": "#/definitions/User"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "User not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "users"
-        ],
-        "description": "Add a new User.",
-        "parameters": [
-          {
-            "name": "user",
-            "in": "body",
-            "description": "The new User.",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/User"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added User.",
-            "schema": {
-              "$ref": "#/definitions/User"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "409": {
-            "description": "User already exists."
-          }
-        }
-      }
-    },
-    "/users/{userId}": {
-      "get": {
-        "tags": [
-          "users"
-        ],
-        "description": "Get this User.",
-        "parameters": [
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved User.",
-            "schema": {
-              "$ref": "#/definitions/User"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "User not found."
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "users"
-        ],
-        "description": "Update this User's given name and/ or family name.",
-        "parameters": [
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "user",
-            "in": "body",
-            "description": "User's new properties.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "givenName": {
-                  "type": "string"
-                },
-                "familyName": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated User.",
-            "schema": {
-              "$ref": "#/definitions/User"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating User."
-          },
-          "404": {
-            "description": "User not found."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "users"
-        ],
-        "description": "Delete this User.",
-        "parameters": [
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted User.",
-            "schema": {
-              "$ref": "#/definitions/User"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting User."
-          },
-          "404": {
-            "description": "User not found."
-          }
-        }
-      }
-    },
-    "/users/{userId}/authorizations": {
-      "get": {
-        "tags": [
-          "authorizations",
-          "users"
-        ],
-        "description": "Get this User's Authorizations.",
-        "parameters": [
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved User's Authorizations.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Authorization"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing parameter or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from viewing User's Authorizations."
-          },
-          "404": {
-            "description": "User not found."
-          }
-        }
-      }
-    },
-    "/simulations": {
-      "post": {
-        "tags": [
-          "simulations"
-        ],
-        "description": "Add a Simulation.",
-        "parameters": [
-          {
-            "name": "simulation",
-            "in": "body",
-            "description": "The new Simulation.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "name": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added Simulation.",
-            "schema": {
-              "$ref": "#/definitions/Simulation"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          }
-        }
-      }
-    },
-    "/simulations/{simulationId}": {
-      "get": {
-        "tags": [
-          "simulations"
-        ],
-        "description": "Get this Simulation.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Simulation.",
-            "schema": {
-              "$ref": "#/definitions/Simulation"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Simulation."
-          },
-          "404": {
-            "description": "Simulation not found"
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "simulations"
-        ],
-        "description": "Update this Simulation's name.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "simulation",
-            "in": "body",
-            "description": "Simulation's new properties.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "name": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated Simulation.",
-            "schema": {
-              "$ref": "#/definitions/Simulation"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating Simulation."
-          },
-          "404": {
-            "description": "Simulation not found."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "simulations"
-        ],
-        "description": "Delete this simulation.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Simulation.",
-            "schema": {
-              "$ref": "#/definitions/Simulation"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting Simulation."
-          },
-          "404": {
-            "description": "Simulation not found."
-          }
-        }
-      }
-    },
-    "/simulations/{simulationId}/authorizations": {
-      "get": {
-        "tags": [
-          "authorizations"
-        ],
-        "description": "Get this Simulation's Authorizations.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Simulation's Authorizations.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Authorization"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving this Simulation's Authorizations."
-          },
-          "404": {
-            "description": "Simulation not found."
-          }
-        }
-      }
-    },
-    "/simulations/{simulationId}/authorizations/{userId}": {
-      "get": {
-        "tags": [
-          "authorizations"
-        ],
-        "description": "Get this User's Authorization over this Simulation.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Authorization.",
-            "schema": {
-              "$ref": "#/definitions/Authorization"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Authorizations for this Simulation."
-          },
-          "404": {
-            "description": "Authorization not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "authorizations"
-        ],
-        "description": "Add an Authorization to this Simulation for this User.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "authorization",
-            "in": "body",
-            "description": "The new Authorization.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "authorizationLevel": {
-                  "type": "string",
-                  "description": "The authorization level, which can be 'VIEW', 'EDIT' or 'OWN'."
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added Authorization to Simulation.",
-            "schema": {
-              "$ref": "#/definitions/Authorization"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter, or invalid authorization level."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding an Authorization to Simulation."
-          },
-          "404": {
-            "description": "Simulation or User not found."
-          },
-          "409": {
-            "description": "An Authorization already exists for User and Simulation."
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "authorizations"
-        ],
-        "description": "Update this User's authorization level over this Simulation.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "authorization",
-            "in": "body",
-            "description": "Authorization's new properties.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "authorizationLevel": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated Authorization.",
-            "schema": {
-              "$ref": "#/definitions/Authorization"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter, or invalid authorization level."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating Authorization."
-          },
-          "404": {
-            "description": "Authorization not found."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "authorizations"
-        ],
-        "description": "Delete this User's Authorization over this Simulation.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "userId",
-            "in": "path",
-            "description": "User's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Authorization.",
-            "schema": {
-              "$ref": "#/definitions/Authorization"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting Authorization."
-          },
-          "404": {
-            "description": "Authorization not found."
-          }
-        }
-      }
-    },
-    "/datacenters/{datacenterId}": {
-      "get": {
-        "tags": [
-          "datacenterDesign"
-        ],
-        "description": "Get this Datacenter.",
-        "parameters": [
-          {
-            "name": "datacenterId",
-            "in": "path",
-            "description": "Datacenter's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Datacenter.",
-            "schema": {
-              "$ref": "#/definitions/Datacenter"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Datacenter."
-          },
-          "404": {
-            "description": "Datacenter not found."
-          }
-        }
-      }
-    },
-    "/datacenters/{datacenterId}/rooms": {
-      "get": {
-        "tags": [
-          "datacenterDesign",
-          "rooms"
-        ],
-        "description": "Get this Datacenter's Rooms.",
-        "parameters": [
-          {
-            "name": "datacenterId",
-            "in": "path",
-            "description": "Datacenter's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Datacenter's Rooms.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Room"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting Datacenter's Rooms."
-          },
-          "404": {
-            "description": "Datacenter not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "datacenterDesign",
-          "rooms"
-        ],
-        "description": "Add a Room.",
-        "parameters": [
-          {
-            "name": "datacenterId",
-            "in": "path",
-            "description": "Datacenter's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "room",
-            "in": "body",
-            "description": "The new Room.",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/Room"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added Room.",
-            "schema": {
-              "$ref": "#/definitions/Room"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter, or ID mismatch."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding a Room to this Datacetner."
-          },
-          "404": {
-            "description": "Datacenter not found."
-          }
-        }
-      }
-    },
-    "/rooms/{roomId}": {
-      "get": {
-        "tags": [
-          "datacenterDesign",
-          "rooms"
-        ],
-        "description": "Get this Room.",
-        "parameters": [
-          {
-            "name": "roomId",
-            "in": "path",
-            "description": "Room's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Room.",
-            "schema": {
-              "$ref": "#/definitions/Room"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting this room"
-          },
-          "404": {
-            "description": "Room not found"
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "datacenterDesign",
-          "rooms"
-        ],
-        "description": "Update a Room's name or type.",
-        "parameters": [
-          {
-            "name": "roomId",
-            "in": "path",
-            "description": "Room's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "room",
-            "in": "body",
-            "description": "Room's new properties.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "name": {
-                  "type": "string"
-                },
-                "roomType": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated Room.",
-            "schema": {
-              "$ref": "#/definitions/Room"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter, or invalid room type."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating this Room."
-          },
-          "404": {
-            "description": "Room not found."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "datacenterDesign",
-          "rooms"
-        ],
-        "description": "Delete this Room.",
-        "parameters": [
-          {
-            "name": "roomId",
-            "in": "path",
-            "description": "Room's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Room.",
-            "schema": {
-              "$ref": "#/definitions/Room"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting this Room."
-          },
-          "404": {
-            "description": "Room not found."
-          }
-        }
-      }
-    },
-    "/rooms/{roomId}/tiles": {
-      "get": {
-        "tags": [
-          "datacenterDesign",
-          "rooms",
-          "tiles"
-        ],
-        "description": "Get this Room's Tiles.",
-        "parameters": [
-          {
-            "name": "roomId",
-            "in": "path",
-            "description": "Room's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Tiles.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Tile"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting Room's Tiles."
-          },
-          "404": {
-            "description": "Room not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "datacenterDesign",
-          "rooms",
-          "tiles"
-        ],
-        "description": "Add a Tile to this Room.",
-        "parameters": [
-          {
-            "name": "roomId",
-            "in": "path",
-            "description": "Room's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "tile",
-            "in": "body",
-            "description": "Tile to add.",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/Tile"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added tile.",
-            "schema": {
-              "$ref": "#/definitions/Tile"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter, or invalid tile position."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding a Tile to this Room."
-          },
-          "404": {
-            "description": "Room not found."
-          },
-          "409": {
-            "description": "Tile location occupied."
-          }
-        }
-      }
-    },
-    "/tiles/{tileId}": {
-      "get": {
-        "tags": [
-          "datacenterDesign",
-          "tiles"
-        ],
-        "description": "Get this Tile.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Tile.",
-            "schema": {
-              "$ref": "#/definitions/Tile"
-            }
-          },
-          "400": {
-            "description": "Mising or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Tile."
-          },
-          "404": {
-            "description": "Tile not found."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "datacenterDesign",
-          "tiles"
-        ],
-        "description": "Delete this Tile.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Tile.",
-            "schema": {
-              "$ref": "#/definitions/Tile"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting Tile."
-          },
-          "404": {
-            "description": "Tile not found."
-          }
-        }
-      }
-    },
-    "/tiles/{tileId}/cooling-item": {
-      "get": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Get this Tile's Cooling Item.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Tile's Cooling Item.",
-            "schema": {
-              "$ref": "#/definitions/CoolingItem"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Tile's Cooling Item."
-          },
-          "404": {
-            "description": "Tile or Cooling Item not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Add a Cooling Item to this Tile if it is empty.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "coolingItemId",
-            "in": "body",
-            "description": "Cooling Item's ID.",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added Cooling Item to Tile.",
-            "schema": {
-              "$ref": "#/definitions/CoolingItem"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding a Cooling Item to Tile."
-          },
-          "404": {
-            "description": "Tile or Cooling Item not found."
-          },
-          "409": {
-            "description": "Tile occupied."
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Update which Cooling Item is on this Tile.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "coolingItemId",
-            "in": "body",
-            "description": "Cooling Item's ID.",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated Cooling Item on Tile.",
-            "schema": {
-              "$ref": "#/definitions/CoolingItem"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating Cooling Item on Tile."
-          },
-          "404": {
-            "description": "Tile or Cooling Item not found."
-          },
-          "409": {
-            "description": "Tile occupied with non-Cooling Item object."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Delete this Tile's Cooling Item.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Tile's Cooling Item.",
-            "schema": {
-              "$ref": "#/definitions/CoolingItem"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting Tile's Cooling Item."
-          },
-          "404": {
-            "description": "Tile or Cooling Item not found."
-          }
-        }
-      }
-    },
-    "/tiles/{tileId}/psu": {
-      "get": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Get this Tile's PSU.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Tile's PSU.",
-            "schema": {
-              "$ref": "#/definitions/PSU"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Tile's PSU."
-          },
-          "404": {
-            "description": "Tile or PSU not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Add a PSU to this Tile if it is empty.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "psuId",
-            "in": "body",
-            "description": "PSU's ID.",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added PSU to Tile.",
-            "schema": {
-              "$ref": "#/definitions/PSU"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding a PSU to Tile."
-          },
-          "404": {
-            "description": "Tile or PSU not found."
-          },
-          "409": {
-            "description": "Tile occupied."
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Update which PSU is on this Tile.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "psuId",
-            "in": "body",
-            "description": "PSU's ID.",
-            "required": true,
-            "schema": {
-              "type": "integer"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated PSU on Tile.",
-            "schema": {
-              "$ref": "#/definitions/PSU"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating PSU on Tile."
-          },
-          "404": {
-            "description": "Tile or PSU not found."
-          },
-          "409": {
-            "description": "Tile occupied with non-PSU object."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Delete this Tile's PSU.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Tile's PSU.",
-            "schema": {
-              "$ref": "#/definitions/PSU"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting Tile's PSU."
-          },
-          "404": {
-            "description": "Tile or PSU not found."
-          }
-        }
-      }
-    },
-    "/tiles/{tileId}/rack": {
-      "get": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Get this Tile's Rack.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Tile's Rack.",
-            "schema": {
-              "$ref": "#/definitions/Rack"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Tile's Rack."
-          },
-          "404": {
-            "description": "Tile or Rack not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Add a Rack to this Tile if it is empty.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "rack",
-            "in": "body",
-            "description": "The new Rack.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "name": {
-                  "type": "string"
-                },
-                "capacity": {
-                  "type": "integer"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added Rack to Tile.",
-            "schema": {
-              "$ref": "#/definitions/Rack"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding a Rack on Tile."
-          },
-          "404": {
-            "description": "Tile not found."
-          },
-          "409": {
-            "description": "Tile occupied."
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Update the Rack on this Tile.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "rack",
-            "in": "body",
-            "description": "PSU's ID.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "name": {
-                  "type": "string"
-                },
-                "capacity": {
-                  "type": "integer"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated Rack on Tile.",
-            "schema": {
-              "$ref": "#/definitions/Rack"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating Rack on Tile."
-          },
-          "404": {
-            "description": "Tile not found."
-          },
-          "409": {
-            "description": "Tile occupied with non-Rack object."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "tiles",
-          "objects"
-        ],
-        "description": "Delete this Tile's Rack.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Tile's Rack.",
-            "schema": {
-              "$ref": "#/definitions/Rack"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting Tile's Rack."
-          },
-          "404": {
-            "description": "Tile or Rack not found."
-          }
-        }
-      }
-    },
-    "/tiles/{tileId}/rack/machines": {
-      "get": {
-        "tags": [
-          "objects",
-          "machines"
-        ],
-        "description": "Get this Rack's Machines.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Machines.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Machine"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting Rack's Machines."
-          },
-          "404": {
-            "description": "Tile or Rack not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "objects",
-          "machines"
-        ],
-        "description": "Add a Machine to this rack",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "machine",
-            "in": "body",
-            "description": "Machine to add to this Rack.",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/Machine"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added Machine to this Rack.",
-            "schema": {
-              "$ref": "#/definitions/Machine"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter, or invalid machine."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding a Machine to Rack."
-          },
-          "404": {
-            "description": "Tile or Rack not found."
-          },
-          "409": {
-            "description": "Machine location already occupied in Rack."
-          }
-        }
-      }
-    },
-    "/tiles/{tileId}/rack/machines/{position}": {
-      "get": {
-        "tags": [
-          "machines"
-        ],
-        "description": "Get the Machine at this location in this Rack.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "position",
-            "in": "path",
-            "description": "Machine's position in the Rack.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved machine",
-            "schema": {
-              "$ref": "#/definitions/Machine"
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "403": {
-            "description": "Forbidden from getting this machine"
-          },
-          "404": {
-            "description": "Machine not found"
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "machines"
-        ],
-        "description": "Update the Machine at this location in this Rack.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "position",
-            "in": "path",
-            "description": "Machine's position in the Rack.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "machine",
-            "in": "body",
-            "description": "Updated machine (ID field must match ID in path)",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/Machine"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated machine",
-            "schema": {
-              "$ref": "#/definitions/Machine"
-            }
-          },
-          "400": {
-            "description": "Incorrect machine specification"
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "403": {
-            "description": "Forbidden from updating this machine"
-          },
-          "404": {
-            "description": "Machine not found"
-          },
-          "409": {
-            "description": "Machine location already occupied in rack"
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "machines"
-        ],
-        "description": "Delete the Machine at this location in this Rack.",
-        "parameters": [
-          {
-            "name": "tileId",
-            "in": "path",
-            "description": "Tile's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "position",
-            "in": "path",
-            "description": "Machine's position in the Rack.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted machine",
-            "schema": {
-              "$ref": "#/definitions/Machine"
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "403": {
-            "description": "Forbidden from deleting this machine"
-          },
-          "404": {
-            "description": "Machine not found"
-          }
-        }
-      }
-    },
-    "/simulations/{simulationId}/experiments": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get this Simulation's Experiments.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Experiments.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Experiment"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Simulation's Experiments."
-          },
-          "404": {
-            "description": "Simulation not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Add a new Experiment for this Simulation.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "experiment",
-            "in": "body",
-            "description": "Experiment to add to this Simulation.",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/Experiment"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added new Experiment.",
-            "schema": {
-              "$ref": "#/definitions/Experiment"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from adding an Experiment to this Simulation."
-          },
-          "404": {
-            "description": "Simulation, Path, Scheduler or Trace not found."
-          }
-        }
-      }
-    },
-    "/experiments/{experimentId}": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get this Experiment.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Experiment.",
-            "schema": {
-              "$ref": "#/definitions/Experiment"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Experiment."
-          },
-          "404": {
-            "description": "Experiment not found."
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Update this Experiment's Path, Trace, Scheduler, and/ or name.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "experiment",
-            "in": "body",
-            "description": "Experiment's new properties.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "pathId": {
-                  "type": "integer"
-                },
-                "traceId": {
-                  "type": "integer"
-                },
-                "schedulerName": {
-                  "type": "integer"
-                },
-                "name": {
-                  "type": "string"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully updated Experiment.",
-            "schema": {
-              "$ref": "#/definitions/Experiment"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from updating Experiment."
-          },
-          "404": {
-            "description": "Experiment, Path, Trace, or Scheduler not found."
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "experiment"
-        ],
-        "description": "Delete this Experiment.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully deleted Experiment.",
-            "schema": {
-              "$ref": "#/definitions/Experiment"
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from deleting Experiment."
-          },
-          "404": {
-            "description": "Experiment not found."
-          }
-        }
-      }
-    },
-    "/experiments/{experimentId}/last-simulated-tick": {
-      "get": {
-        "tags": [
-          "simulations"
-        ],
-        "description": "Get this Experiment's last simulated tick.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Experiment's last simulated tick.",
-            "schema": {
-              "properties": {
-                "lastSimulatedTick": {
-                  "type": "integer"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "403": {
-            "description": "Forbidden from getting this simulation"
-          },
-          "404": {
-            "description": "Simulation not found"
-          }
-        }
-      }
-    },
-    "/experiments/{experimentId}/machine-states": {
-      "get": {
-        "tags": [
-          "simulations",
-          "machines",
-          "states"
-        ],
-        "description": "Get this experiment's Machine States.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "tick",
-            "in": "query",
-            "description": "Tick to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "machineId",
-            "in": "query",
-            "description": "Machine's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "rackId",
-            "in": "query",
-            "description": "Rack's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "roomId",
-            "in": "query",
-            "description": "Room's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Machine States.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/MachineState"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting Experiment's Machine States."
-          },
-          "404": {
-            "description": "Experiment, Machine, Rack, Room or Tick not found."
-          }
-        }
-      }
-    },
-    "/experiments/{experimentId}/rack-states": {
-      "get": {
-        "tags": [
-          "simulations",
-          "objects",
-          "states"
-        ],
-        "description": "Get this Experiment's Rack States.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "tick",
-            "in": "query",
-            "description": "Tick to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "rackId",
-            "in": "query",
-            "description": "Rack's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "roomId",
-            "in": "query",
-            "description": "Room's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Rack States.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/RackState"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting Experiment's Rack States."
-          },
-          "404": {
-            "description": "Experiment, Room, Rack or Tick not found."
-          }
-        }
-      }
-    },
-    "/experiments/{experimentId}/room-states": {
-      "get": {
-        "tags": [
-          "simulations",
-          "rooms",
-          "states"
-        ],
-        "description": "Get this Experiment's Room States.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "tick",
-            "in": "query",
-            "description": "Tick to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "roomId",
-            "in": "query",
-            "description": "Room's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Room States.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/RoomState"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting Experiment's Room States."
-          },
-          "404": {
-            "description": "Experiment, Room or Tick not found."
-          }
-        }
-      }
-    },
-    "/experiments/{experimentId}/task-states": {
-      "get": {
-        "tags": [
-          "simulations",
-          "tasks",
-          "states"
-        ],
-        "description": "Get this Experiment's Task States.",
-        "parameters": [
-          {
-            "name": "experimentId",
-            "in": "path",
-            "description": "Experiment's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "tick",
-            "in": "query",
-            "description": "Tick to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "taskId",
-            "in": "query",
-            "description": "Task's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "machineId",
-            "in": "query",
-            "description": "Machine's ID to filter on.",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "rackId",
-            "in": "query",
-            "description": "ID the rack whose machines' task states to get",
-            "required": false,
-            "type": "integer"
-          },
-          {
-            "name": "roomId",
-            "in": "query",
-            "description": "ID of the room whose racks' machines' states to get",
-            "required": false,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Task States.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/TaskState"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Experiment's Task States."
-          },
-          "404": {
-            "description": "Experiment, Tick, Task, Machine, Rack or Room not found."
-          }
-        }
-      }
-    },
-    "/simulations/{simulationId}/paths": {
-      "get": {
-        "tags": [
-          "paths"
-        ],
-        "description": "Get this Simulation's Paths.",
-        "parameters": [
-          {
-            "name": "simulationId",
-            "in": "path",
-            "description": "Simulation's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Simulation's Paths.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Path"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Simulation's Paths."
-          },
-          "404": {
-            "description": "Simulation not found."
-          }
-        }
-      }
-    },
-    "/paths/{pathId}": {
-      "get": {
-        "tags": [
-          "paths"
-        ],
-        "description": "Get this Path.",
-        "parameters": [
-          {
-            "name": "pathId",
-            "in": "path",
-            "description": "Path's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Path.",
-            "schema": {
-              "$ref": "#/definitions/Path"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving this Path."
-          },
-          "404": {
-            "description": "Path not found."
-          }
-        }
-      }
-    },
-    "/paths/{pathId}/branches": {
-      "get": {
-        "tags": [
-          "paths"
-        ],
-        "description": "Get this Path's branches - Paths that start with this Path's Sections.",
-        "parameters": [
-          {
-            "name": "pathId",
-            "in": "path",
-            "description": "Path's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Paths.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Path"
-              }
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Path's branches."
-          },
-          "404": {
-            "description": "Path not found."
-          }
-        }
-      },
-      "post": {
-        "tags": [
-          "paths"
-        ],
-        "description": "Create a new Path that branches off of this Path at the specified tick.",
-        "parameters": [
-          {
-            "name": "pathId",
-            "in": "path",
-            "description": "Path's ID.",
-            "required": true,
-            "type": "integer"
-          },
-          {
-            "name": "section",
-            "in": "body",
-            "description": "New Path's Section.",
-            "required": true,
-            "schema": {
-              "properties": {
-                "startTick": {
-                  "type": "integer"
-                }
-              }
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully added Path.",
-            "schema": {
-              "$ref": "#/definitions/Path"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from branching off this Path."
-          },
-          "404": {
-            "description": "Path not found."
-          }
-        }
-      }
-    },
-    "/paths/{pathId}/sections": {
-      "get": {
-        "tags": [
-          "paths"
-        ],
-        "description": "Get this Path's Sections.",
-        "parameters": [
-          {
-            "name": "pathId",
-            "in": "path",
-            "description": "Path's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Sections.",
-            "schema": {
-              "$ref": "#/definitions/Section"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from retrieving Path's Sections."
-          },
-          "404": {
-            "description": "Path not found."
-          }
-        }
-      }
-    },
-    "/sections/{sectionId}": {
-      "get": {
-        "tags": [
-          "simulations"
-        ],
-        "description": "Get this Section.",
-        "parameters": [
-          {
-            "name": "sectionId",
-            "in": "path",
-            "description": "Section's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Section.",
-            "schema": {
-              "$ref": "#/definitions/Section"
-            }
-          },
-          "400": {
-            "description": "Missing or incorrectly typed parameter."
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "403": {
-            "description": "Forbidden from getting Section."
-          },
-          "404": {
-            "description": "Section not found."
-          }
-        }
-      }
-    },
-    "/schedulers": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get all available Schedulers",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Schedulers.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Scheduler"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          }
-        }
-      }
-    },
-    "/traces": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get all avaialble Traces.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Traces.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Trace"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          }
-        }
-      }
-    },
-    "/traces/{traceId}": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get this Trace.",
-        "parameters": [
-          {
-            "name": "traceId",
-            "in": "path",
-            "description": "Trace's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Trace.",
-            "schema": {
-              "$ref": "#/definitions/Trace"
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "Trace not found."
-          }
-        }
-      }
-    },
-    "/traces/{traceId}/jobs": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get this Trace's Jobs.",
-        "parameters": [
-          {
-            "name": "traceId",
-            "in": "path",
-            "description": "Trace's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Jobs.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Job"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "Trace not found."
-          }
-        }
-      }
-    },
-    "/jobs/{jobId}": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get this Job.",
-        "parameters": [
-          {
-            "name": "jobId",
-            "in": "path",
-            "description": "Job's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Job.",
-            "schema": {
-              "$ref": "#/definitions/Job"
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "Trace or Job not found."
-          }
-        }
-      }
-    },
-    "/jobs/{jobId}/tasks": {
-      "get": {
-        "tags": [
-          "experiments"
-        ],
-        "description": "Get this Job's Tasks.",
-        "parameters": [
-          {
-            "name": "jobId",
-            "in": "path",
-            "description": "Job's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Tasks.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Task"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "Trace or Job not found."
-          }
-        }
-      }
-    },
-    "/room-types": {
-      "get": {
-        "tags": [
-          "datacenterDesign",
-          "rooms"
-        ],
-        "description": "Get all available room types.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Room Types.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/RoomType"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          }
-        }
-      }
-    },
-    "/room-types/{name}/allowed-objects": {
-      "get": {
-        "tags": [
-          "datacenterDesign",
-          "rooms",
-          "objects"
-        ],
-        "description": "Get this room's allowed objects.",
-        "parameters": [
-          {
-            "name": "name",
-            "in": "path",
-            "description": "Room Type's name.",
-            "required": true,
-            "type": "string"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved allowed object types.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "Room Type not found."
-          }
-        }
-      }
-    },
-    "/specifications/cooling-items": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get all Cooling Items.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Cooling Items.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/CoolingItem"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          }
-        }
-      }
-    },
-    "/specifications/cooling-items/{id}": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get this Cooling Item.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "description": "Cooling Item's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Cooling Item.",
-            "schema": {
-              "$ref": "#/definitions/CoolingItem"
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "Cooling Item not found."
-          }
-        }
-      }
-    },
-    "/specifications/cpus": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get a list of the specifications of all CPUs.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the CPU spec list",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/CPU"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          }
-        }
-      }
-    },
-    "/specifications/cpus/{id}": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get the specs of a CPU.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "description": "ID of the CPU whose specs to get",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the CPU specs",
-            "schema": {
-              "$ref": "#/definitions/CPU"
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "404": {
-            "description": "CPU specs not found"
-          }
-        }
-      }
-    },
-    "/specifications/failure-models": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get all Failure Models.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Failure Models.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/FailureModel"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          }
-        }
-      }
-    },
-    "/specifications/failure-models/{id}": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get this Failure Model.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "description": "Failure Model's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved Failure Model.",
-            "schema": {
-              "$ref": "#/definitions/FailureModel"
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "Failure Model not found."
-          }
-        }
-      }
-    },
-    "/specifications/gpus": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get a list of the specifications of all GPUs.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the GPU spec list",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/GPU"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          }
-        }
-      }
-    },
-    "/specifications/gpus/{id}": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get the specs of a GPU.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "description": "ID of the GPU whose specs to get",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the GPU specs",
-            "schema": {
-              "$ref": "#/definitions/GPU"
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "404": {
-            "description": "GPU specs not found"
-          }
-        }
-      }
-    },
-    "/specifications/memories": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get a list of the specifications of all memory devices.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the memory spec list",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Memory"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          }
-        }
-      }
-    },
-    "/specifications/memories/{id}": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get the specs of a memory device.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "description": "ID of the memory device whose specs to get",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the memory device specs",
-            "schema": {
-              "$ref": "#/definitions/Memory"
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "404": {
-            "description": "Memory device specs not found"
-          }
-        }
-      }
-    },
-    "/specifications/psus": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get all PSUs.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved PSUs.",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/PSU"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          }
-        }
-      }
-    },
-    "/specifications/psus/{id}": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get this PSU.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "description": "PSU's ID.",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved PSU.",
-            "schema": {
-              "$ref": "#/definitions/PSU"
-            }
-          },
-          "401": {
-            "description": "Unauthorized."
-          },
-          "404": {
-            "description": "PSU not found."
-          }
-        }
-      }
-    },
-    "/specifications/storages": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get a list of the specifications of all storage devices.",
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the storage spec list",
-            "schema": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/Storage"
-              }
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          }
-        }
-      }
-    },
-    "/specifications/storages/{id}": {
-      "get": {
-        "tags": [
-          "devices",
-          "machines"
-        ],
-        "description": "Get the specs of a storage device.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "description": "ID of the storage device whose specs to get",
-            "required": true,
-            "type": "integer"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Successfully retrieved the storage device specs",
-            "schema": {
-              "$ref": "#/definitions/Storage"
-            }
-          },
-          "401": {
-            "description": "Unauthorized"
-          },
-          "404": {
-            "description": "Storage device specs not found"
-          }
-        }
-      }
-    }
-  },
-  "definitions": {
-    "Authorization": {
-      "type": "object",
-      "properties": {
-        "userId": {
-          "type": "integer"
-        },
-        "simulationId": {
-          "type": "integer"
-        },
-        "authorizationLevel": {
-          "type": "string"
-        }
-      }
-    },
-    "CoolingItem": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "energyConsumptionW": {
-          "type": "integer"
-        },
-        "type": {
-          "type": "string"
-        },
-        "failureModelId": {
-          "type": "integer"
-        }
-      }
-    },
-    "CPU": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "manufacturer": {
-          "type": "string"
-        },
-        "family": {
-          "type": "string"
-        },
-        "generation": {
-          "type": "string"
-        },
-        "model": {
-          "type": "string"
-        },
-        "clockRateMhz": {
-          "type": "integer"
-        },
-        "numberOfCores": {
-          "type": "integer"
-        },
-        "energyConsumptionW": {
-          "type": "number",
-          "format": "float"
-        },
-        "failureModelId": {
-          "type": "integer"
-        }
-      }
-    },
-    "Datacenter": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        }
-      }
-    },
-    "Experiment": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "simulationId": {
-          "type": "integer"
-        },
-        "pathId": {
-          "type": "integer"
-        },
-        "traceId": {
-          "type": "integer"
-        },
-        "schedulerName": {
-          "type": "string"
-        },
-        "name": {
-          "type": "string"
-        }
-      }
-    },
-    "FailureModel": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "name": {
-          "type": "string"
-        },
-        "rate": {
-          "type": "number",
-          "format": "float"
-        }
-      }
-    },
-    "GPU": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "manufacturer": {
-          "type": "string"
-        },
-        "family": {
-          "type": "string"
-        },
-        "generation": {
-          "type": "string"
-        },
-        "model": {
-          "type": "string"
-        },
-        "clockRateMhz": {
-          "type": "integer"
-        },
-        "numberOfCores": {
-          "type": "integer"
-        },
-        "energyConsumptionW": {
-          "type": "number",
-          "format": "float"
-        },
-        "failureModelId": {
-          "type": "integer"
-        }
-      }
-    },
-    "Job": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "name": {
-          "type": "string"
-        },
-        "traceId": {
-          "type": "integer"
-        }
-      }
-    },
-    "Machine": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "rackId": {
-          "type": "integer"
-        },
-        "position": {
-          "type": "integer"
-        },
-        "tags": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "cpuIds": {
-          "type": "array",
-          "items": {
-            "type": "integer"
-          }
-        },
-        "gpuIds": {
-          "type": "array",
-          "items": {
-            "type": "integer"
-          }
-        },
-        "memoryIds": {
-          "type": "array",
-          "items": {
-            "type": "integer"
-          }
-        },
-        "storageIds": {
-          "type": "array",
-          "items": {
-            "type": "integer"
-          }
-        }
-      }
-    },
-    "MachineState": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "machineId": {
-          "type": "integer"
-        },
-        "experimentId": {
-          "type": "integer"
-        },
-        "tick": {
-          "type": "integer"
-        },
-        "temperatureC": {
-          "type": "number",
-          "format": "float"
-        },
-        "inUseMemoryMb": {
-          "type": "integer"
-        },
-        "loadFraction": {
-          "type": "number",
-          "format": "float"
-        }
-      }
-    },
-    "Memory": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "manufacturer": {
-          "type": "string"
-        },
-        "family": {
-          "type": "string"
-        },
-        "generation": {
-          "type": "string"
-        },
-        "model": {
-          "type": "string"
-        },
-        "speedMbPerS": {
-          "type": "integer"
-        },
-        "sizeMb": {
-          "type": "integer"
-        },
-        "energyConsumptionW": {
-          "type": "number",
-          "format": "float"
-        },
-        "failureModelId": {
-          "type": "integer"
-        }
-      }
-    },
-    "Path": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "simulationId": {
-          "type": "integer"
-        },
-        "name": {
-          "type": "string"
-        },
-        "datetimeCreated": {
-          "type": "string"
-        }
-      }
-    },
-    "PSU": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "energyKwh": {
-          "type": "integer"
-        },
-        "type": {
-          "type": "string"
-        },
-        "failureModelId": {
-          "type": "integer"
-        }
-      }
-    },
-    "Rack": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "name": {
-          "type": "string"
-        },
-        "capacity": {
-          "type": "integer"
-        },
-        "powerCapacityW": {
-          "type": "integer"
-        }
-      }
-    },
-    "RackState": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "rackId": {
-          "type": "integer"
-        },
-        "experimentId": {
-          "type": "integer"
-        },
-        "tick": {
-          "type": "integer"
-        },
-        "temperatureC": {
-          "type": "number",
-          "format": "float"
-        },
-        "inUseMemoryMb": {
-          "type": "integer"
-        },
-        "loadFraction": {
-          "type": "number",
-          "format": "float"
-        }
-      }
-    },
-    "Room": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "datacenterId": {
-          "type": "integer"
-        },
-        "name": {
-          "type": "string"
-        },
-        "roomType": {
-          "type": "string"
-        }
-      }
-    },
-    "RoomState": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "roomId": {
-          "type": "integer"
-        },
-        "experimentId": {
-          "type": "integer"
-        },
-        "tick": {
-          "type": "integer"
-        },
-        "temperatureC": {
-          "type": "number",
-          "format": "float"
-        },
-        "inUseMemoryMb": {
-          "type": "integer"
-        },
-        "loadFraction": {
-          "type": "number",
-          "format": "float"
-        }
-      }
-    },
-    "RoomType": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string"
-        }
-      }
-    },
-    "Scheduler": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string"
-        }
-      }
-    },
-    "Simulation": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "name": {
-          "type": "string"
-        },
-        "datetimeCreated": {
-          "type": "string",
-          "format": "dateTime"
-        },
-        "datetimeLastEdited": {
-          "type": "string",
-          "format": "dateTime"
-        }
-      }
-    },
-    "Section": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "pathId": {
-          "type": "integer"
-        },
-        "datacenterId": {
-          "type": "integer"
-        },
-        "startTick": {
-          "type": "integer"
-        }
-      }
-    },
-    "Storage": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "manufacturer": {
-          "type": "string"
-        },
-        "family": {
-          "type": "string"
-        },
-        "generation": {
-          "type": "string"
-        },
-        "model": {
-          "type": "string"
-        },
-        "speedMbPerS": {
-          "type": "integer"
-        },
-        "sizeMb": {
-          "type": "integer"
-        },
-        "energyConsumptionW": {
-          "type": "number",
-          "format": "float"
-        },
-        "failureModelId": {
-          "type": "integer"
-        }
-      }
-    },
-    "Task": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "jobId": {
-          "type": "integer"
-        },
-        "startTick": {
-          "type": "integer"
-        },
-        "totalFlopCount": {
-          "type": "integer"
-        }
-      }
-    },
-    "TaskState": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "taskId": {
-          "type": "integer"
-        },
-        "experimentId": {
-          "type": "integer"
-        },
-        "tick": {
-          "type": "integer"
-        },
-        "flopsLeft": {
-          "type": "integer"
-        }
-      }
-    },
-    "Tile": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "roomId": {
-          "type": "integer"
-        },
-        "objectId": {
-          "type": "integer"
-        },
-        "objectType": {
-          "type": "string"
-        },
-        "positionX": {
-          "type": "integer"
-        },
-        "positionY": {
-          "type": "integer"
-        }
-      }
-    },
-    "Trace": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "name": {
-          "type": "string"
-        }
-      }
-    },
-    "User": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "integer"
-        },
-        "googleId": {
-          "type": "integer"
-        },
-        "email": {
-          "type": "string"
-        },
-        "givenName": {
-          "type": "string"
-        },
-        "familyName": {
-          "type": "string"
-        }
-      }
-    }
-  }
-}
diff --git a/opendc-api-spec.yml b/opendc-api-spec.yml
new file mode 100644
index 00000000..3d27175c
--- /dev/null
+++ b/opendc-api-spec.yml
@@ -0,0 +1,994 @@
+swagger: '2.0'
+info:
+  version: 1.0.0
+  title: OpenDC API
+  description: 'OpenDC is an open-source datacenter simulator for education, featuring real-time online collaboration, diverse simulation models, and detailed performance feedback statistics.'
+host: opendc.org
+basePath: /v2
+schemes:
+  - https
+
+paths:
+  '/users':
+    get:
+      tags:
+        - users
+      description: Search for a User using their email address.
+      parameters:
+        - name: email
+          in: query
+          description: User's email address.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully searched Users.
+          schema:
+            $ref: '#/definitions/User'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '404':
+          description: User not found.
+    post:
+      tags:
+        - users
+      description: Add a new User.
+      parameters:
+        - name: user
+          in: body
+          description: The new User.
+          required: true
+          schema:
+            $ref: '#/definitions/User'
+      responses:
+        '200':
+          description: Successfully added User.
+          schema:
+            $ref: '#/definitions/User'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '409':
+          description: User already exists.
+  '/users/{userId}':
+    get:
+      tags:
+        - users
+      description: Get this User.
+      parameters:
+        - name: userId
+          in: path
+          description: User's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved User.
+          schema:
+            $ref: '#/definitions/User'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '404':
+          description: User not found.
+    put:
+      tags:
+        - users
+      description: Update this User's given name and/ or family name.
+      parameters:
+        - name: userId
+          in: path
+          description: User's ID.
+          required: true
+          type: string
+        - name: user
+          in: body
+          description: User's new properties.
+          required: true
+          schema:
+            properties:
+              givenName:
+                type: string
+              familyName:
+                type: string
+      responses:
+        '200':
+          description: Successfully updated User.
+          schema:
+            $ref: '#/definitions/User'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from updating User.
+        '404':
+          description: User not found.
+    delete:
+      tags:
+        - users
+      description: Delete this User.
+      parameters:
+        - name: userId
+          in: path
+          description: User's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully deleted User.
+          schema:
+            $ref: '#/definitions/User'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from deleting User.
+        '404':
+          description: User not found.
+  '/simulations':
+    post:
+      tags:
+        - simulations
+      description: Add a Simulation.
+      parameters:
+        - name: simulation
+          in: body
+          description: The new Simulation.
+          required: true
+          schema:
+            properties:
+              name:
+                type: string
+      responses:
+        '200':
+          description: Successfully added Simulation.
+          schema:
+            $ref: '#/definitions/Simulation'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+  '/simulations/{simulationId}':
+    get:
+      tags:
+        - simulations
+      description: Get this Simulation.
+      parameters:
+        - name: simulationId
+          in: path
+          description: Simulation's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Simulation.
+          schema:
+            $ref: '#/definitions/Simulation'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from retrieving Simulation.
+        '404':
+          description: Simulation not found
+    put:
+      tags:
+        - simulations
+      description: Update this Simulation.
+      parameters:
+        - name: simulationId
+          in: path
+          description: Simulation's ID.
+          required: true
+          type: string
+        - name: simulation
+          in: body
+          description: Simulation's new properties.
+          required: true
+          schema:
+            properties:
+              simulation:
+                $ref: '#/definitions/Simulation'
+      responses:
+        '200':
+          description: Successfully updated Simulation.
+          schema:
+            $ref: '#/definitions/Simulation'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from updating Simulation.
+        '404':
+          description: Simulation not found.
+    delete:
+      tags:
+        - simulations
+      description: Delete this simulation.
+      parameters:
+        - name: simulationId
+          in: path
+          description: Simulation's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully deleted Simulation.
+          schema:
+            $ref: '#/definitions/Simulation'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from deleting Simulation.
+        '404':
+          description: Simulation not found.
+  '/simulations/{simulationId}/authorizations':
+    get:
+      tags:
+        - simulations
+      description: Get this Simulation's Authorizations.
+      parameters:
+        - name: simulationId
+          in: path
+          description: Simulation's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Simulation's Authorizations.
+          schema:
+            type: array
+            items:
+              type: object
+              properties:
+                userId:
+                  type: string
+                simulationId:
+                  type: string
+                authorizationLevel:
+                  type: string
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from retrieving this Simulation's Authorizations.
+        '404':
+          description: Simulation not found.
+  '/topologies':
+    post:
+      tags:
+        - topologies
+      description: Add a Topology.
+      parameters:
+        - name: topology
+          in: body
+          description: The new Topology.
+          required: true
+          schema:
+            properties:
+              topology:
+                $ref: '#/definitions/Topology'
+      responses:
+        '200':
+          description: Successfully added Topology.
+          schema:
+            $ref: '#/definitions/Topology'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+  '/topologies/{topologyId}':
+    get:
+      tags:
+        - topologies
+      description: Get this Topology.
+      parameters:
+        - name: topologyId
+          in: path
+          description: Topology's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Topology.
+          schema:
+            $ref: '#/definitions/Topology'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from retrieving Topology.
+        '404':
+          description: Topology not found.
+    put:
+      tags:
+        - topologies
+      description: Update this Topology's name.
+      parameters:
+        - name: topologyId
+          in: path
+          description: Topology's ID.
+          required: true
+          type: string
+        - name: topology
+          in: body
+          description: Topology's new properties.
+          required: true
+          schema:
+            properties:
+              topology:
+                $ref: '#/definitions/Topology'
+      responses:
+        '200':
+          description: Successfully updated Topology.
+          schema:
+            $ref: '#/definitions/Topology'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from updating Topology.
+        '404':
+          description: Topology not found.
+    delete:
+      tags:
+        - topologies
+      description: Delete this Topology.
+      parameters:
+        - name: topologyId
+          in: path
+          description: Topology's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully deleted Topology.
+          schema:
+            $ref: '#/definitions/Topology'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from deleting Topology.
+        '404':
+          description: Topology not found.
+  '/simulations/{simulationId}/experiments':
+    get:
+      tags:
+        - experiments
+      description: Get this Simulation's Experiments.
+      parameters:
+        - name: simulationId
+          in: path
+          description: Simulation's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Experiments.
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/Experiment'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from retrieving Simulation's Experiments.
+        '404':
+          description: Simulation not found.
+    post:
+      tags:
+        - experiments
+      description: Add a new Experiment for this Simulation.
+      parameters:
+        - name: simulationId
+          in: path
+          description: Simulation's ID.
+          required: true
+          type: string
+        - name: experiment
+          in: body
+          description: Experiment to add to this Simulation.
+          required: true
+          schema:
+            $ref: '#/definitions/Experiment'
+      responses:
+        '200':
+          description: Successfully added new Experiment.
+          schema:
+            $ref: '#/definitions/Experiment'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from adding an Experiment to this Simulation.
+        '404':
+          description: 'Simulation, Topology, Scheduler or Trace not found.'
+  '/experiments/{experimentId}':
+    get:
+      tags:
+        - experiments
+      description: Get this Experiment.
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Experiment.
+          schema:
+            $ref: '#/definitions/Experiment'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from retrieving Experiment.
+        '404':
+          description: Experiment not found.
+    put:
+      tags:
+        - experiments
+      description: "Update this Experiment's Topology, Trace, Scheduler, and/or name."
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+        - name: experiment
+          in: body
+          description: Experiment's new properties.
+          required: true
+          schema:
+            properties:
+              topologyId:
+                type: string
+              traceId:
+                type: string
+              schedulerName:
+                type: string
+              name:
+                type: string
+      responses:
+        '200':
+          description: Successfully updated Experiment.
+          schema:
+            $ref: '#/definitions/Experiment'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from updating Experiment.
+        '404':
+          description: 'Experiment, Topology, Trace, or Scheduler not found.'
+    delete:
+      tags:
+        - experiments
+      description: Delete this Experiment.
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully deleted Experiment.
+          schema:
+            $ref: '#/definitions/Experiment'
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from deleting Experiment.
+        '404':
+          description: Experiment not found.
+  '/experiments/{experimentId}/last-simulated-tick':
+    get:
+      tags:
+        - simulations
+      description: Get this Experiment's last simulated tick.
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Experiment's last simulated tick.
+          schema:
+            properties:
+              lastSimulatedTick:
+                type: integer
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized
+        '403':
+          description: Forbidden from getting this simulation
+        '404':
+          description: Simulation not found
+  '/experiments/{experimentId}/machine-states':
+    get:
+      tags:
+        - simulations
+        - states
+      description: Get this experiment's Machine States.
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+        - name: tick
+          in: query
+          description: Tick to filter on.
+          required: false
+          type: integer
+        - name: machineId
+          in: query
+          description: Machine's ID to filter on.
+          required: false
+          type: string
+        - name: rackId
+          in: query
+          description: Rack's ID to filter on.
+          required: false
+          type: string
+        - name: roomId
+          in: query
+          description: Room's ID to filter on.
+          required: false
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Machine States.
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/MachineState'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from getting Experiment's Machine States.
+        '404':
+          description: 'Experiment, Machine, Rack, Room or Tick not found.'
+  '/experiments/{experimentId}/rack-states':
+    get:
+      tags:
+        - simulations
+        - states
+      description: Get this Experiment's Rack States.
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+        - name: tick
+          in: query
+          description: Tick to filter on.
+          required: false
+          type: integer
+        - name: rackId
+          in: query
+          description: Rack's ID to filter on.
+          required: false
+          type: string
+        - name: roomId
+          in: query
+          description: Room's ID to filter on.
+          required: false
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Rack States.
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/RackState'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from getting Experiment's Rack States.
+        '404':
+          description: 'Experiment, Room, Rack or Tick not found.'
+  '/experiments/{experimentId}/room-states':
+    get:
+      tags:
+        - simulations
+        - states
+      description: Get this Experiment's Room States.
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+        - name: tick
+          in: query
+          description: Tick to filter on.
+          required: false
+          type: integer
+        - name: roomId
+          in: query
+          description: Room's ID to filter on.
+          required: false
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Room States.
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/RoomState'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from getting Experiment's Room States.
+        '404':
+          description: 'Experiment, Room or Tick not found.'
+  '/experiments/{experimentId}/task-states':
+    get:
+      tags:
+        - simulations
+        - states
+      description: Get this Experiment's Task States.
+      parameters:
+        - name: experimentId
+          in: path
+          description: Experiment's ID.
+          required: true
+          type: string
+        - name: tick
+          in: query
+          description: Tick to filter on.
+          required: false
+          type: integer
+        - name: taskId
+          in: query
+          description: Task's ID to filter on.
+          required: false
+          type: string
+        - name: machineId
+          in: query
+          description: Machine's ID to filter on.
+          required: false
+          type: string
+        - name: rackId
+          in: query
+          description: ID the rack whose machines' task states to get
+          required: false
+          type: string
+        - name: roomId
+          in: query
+          description: ID of the room whose racks' machines' states to get
+          required: false
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Task States.
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/TaskState'
+        '400':
+          description: Missing or incorrectly typed parameter.
+        '401':
+          description: Unauthorized.
+        '403':
+          description: Forbidden from retrieving Experiment's Task States.
+        '404':
+          description: 'Experiment, Tick, Task, Machine, Rack or Room not found.'
+  /schedulers:
+    get:
+      tags:
+        - experiments
+      description: Get all available Schedulers
+      responses:
+        '200':
+          description: Successfully retrieved Schedulers.
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/Scheduler'
+        '401':
+          description: Unauthorized.
+  /traces:
+    get:
+      tags:
+        - experiments
+      description: Get all available Traces (non-populated).
+      responses:
+        '200':
+          description: Successfully retrieved Traces (non-populated).
+          schema:
+            type: array
+            items:
+              type: object
+              properties:
+                _id:
+                  type: string
+                name:
+                  type: string
+        '401':
+          description: Unauthorized.
+  '/traces/{traceId}':
+    get:
+      tags:
+        - experiments
+      description: Get this Trace.
+      parameters:
+        - name: traceId
+          in: path
+          description: Trace's ID.
+          required: true
+          type: string
+      responses:
+        '200':
+          description: Successfully retrieved Trace.
+          schema:
+            $ref: '#/definitions/Trace'
+        '401':
+          description: Unauthorized.
+        '404':
+          description: Trace not found.
+
+definitions:
+  Experiment:
+    type: object
+    properties:
+      _id:
+        type: string
+      simulationId:
+        type: string
+      topologyId:
+        type: string
+      traceId:
+        type: string
+      schedulerName:
+        type: string
+      name:
+        type: string
+  MachineState:
+    type: object
+    properties:
+      _id:
+        type: string
+      machineId:
+        type: string
+      experimentId:
+        type: string
+      tick:
+        type: integer
+      inUseMemoryMb:
+        type: integer
+      loadFraction:
+        type: number
+        format: float
+  RackState:
+    type: object
+    properties:
+      _id:
+        type: string
+      rackId:
+        type: string
+      experimentId:
+        type: string
+      tick:
+        type: integer
+      inUseMemoryMb:
+        type: integer
+      loadFraction:
+        type: number
+        format: float
+  RoomState:
+    type: object
+    properties:
+      _id:
+        type: string
+      roomId:
+        type: string
+      experimentId:
+        type: string
+      tick:
+        type: integer
+      inUseMemoryMb:
+        type: integer
+      loadFraction:
+        type: number
+        format: float
+  Scheduler:
+    type: object
+    properties:
+      name:
+        type: string
+  Simulation:
+    type: object
+    properties:
+      _id:
+        type: string
+      name:
+        type: string
+      datetimeCreated:
+        type: string
+        format: dateTime
+      datetimeLastEdited:
+        type: string
+        format: dateTime
+      topologyIds:
+        type: array
+        items:
+          type: string
+  TaskState:
+    type: object
+    properties:
+      _id:
+        type: string
+      taskId:
+        type: string
+      experimentId:
+        type: string
+      tick:
+        type: integer
+      flopsLeft:
+        type: integer
+  Topology:
+    type: object
+    properties:
+      _id:
+        type: string
+      name:
+        type: string
+      rooms:
+        type: array
+        items:
+          type: object
+          properties:
+            _id:
+              type: string
+            name:
+              type: string
+            tiles:
+              type: array
+              items:
+                type: object
+                properties:
+                  _id:
+                    type: string
+                  positionX:
+                    type: integer
+                  positionY:
+                    type: integer
+                  object:
+                    type: object
+                    properties:
+                      capacity:
+                        type: integer
+                      powerCapacityW:
+                        type: integer
+                      machines:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            position:
+                              type: integer
+                            cpuItems:
+                              type: array
+                              items:
+                                type: object
+                                properties:
+                                  name:
+                                    type: string
+                                  clockRateMhz:
+                                    type: integer
+                                  numberOfCores:
+                                    type: integer
+                            gpuItems:
+                              type: array
+                              items:
+                                type: object
+                                properties:
+                                  name:
+                                    type: string
+                                  clockRateMhz:
+                                    type: integer
+                                  numberOfCores:
+                                    type: integer
+                            memoryItems:
+                              type: array
+                              items:
+                                type: object
+                                properties:
+                                  name:
+                                    type: string
+                                  speedMbPerS:
+                                    type: integer
+                                  sizeMb:
+                                    type: integer
+                            storageItems:
+                              type: array
+                              items:
+                                type: integer
+                                properties:
+                                  name:
+                                    type: string
+                                  speedMbPerS:
+                                    type: integer
+                                  sizeMb:
+                                    type: integer
+  Trace:
+    type: object
+    properties:
+      _id:
+        type: string
+      name:
+        type: string
+      jobs:
+        type: array
+        items:
+          type: object
+          properties:
+            _id:
+              type: string
+            name:
+              type: string
+            tasks:
+              type: array
+              items:
+                type: object
+                properties:
+                  startTick:
+                    type: integer
+                  totalFlopCount:
+                    type: integer
+  User:
+    type: object
+    properties:
+      _id:
+        type: string
+      googleId:
+        type: integer
+      email:
+        type: string
+      givenName:
+        type: string
+      familyName:
+        type: string
+      authorizations:
+        type: array
+        items:
+          type: object
+          properties:
+            simulationId:
+              type: string
+            authorizationLevel:
+              type: string