Kill switch

microservices/LocationsApi/DOCUMENTS.md

@@ -21,6 +21,14 @@ Inbound JSON documents
   }
   ```
   `coord` cannot be updated.
+- ResetWorldRequest (`POST /api/locations/reset-world`)
+  ```json
+  {
+    "confirmDeleteAllNonOriginLocations": true,
+    "confirmationPhrase": "RESET WORLD TO ORIGIN"
+  }
+  ```
+  Both fields are required for the request to be accepted.
 - GatherResourceRequest (`POST /api/locations/{id}/gather`)
   ```json
   {
@@ -63,3 +71,40 @@ Outbound JSON documents
     "inventoryResponseJson": "string (raw InventoryApi response JSON)"
   }
   ```
+- ResetWorldResponse (`POST /api/locations/reset-world`)
+  ```json
+  {
+    "deletedLocationCount": 42,
+    "remainingLocationCount": 2,
+    "movedCharacterCount": 5,
+    "reassignedInventoryItemCount": 19,
+    "origin": {
+      "id": "string (ObjectId)",
+      "name": "Origin",
+      "coord": {
+        "x": 0,
+        "y": 0
+      },
+      "biomeKey": "plains",
+      "elevation": 0,
+      "resources": [],
+      "locationObject": null,
+      "locationObjectResolved": true,
+      "createdUtc": "string (ISO-8601 datetime)"
+    },
+    "limbo": {
+      "id": "string (ObjectId)",
+      "name": "World Limbo",
+      "coord": {
+        "x": -2000000000,
+        "y": -2000000000
+      },
+      "biomeKey": "plains",
+      "elevation": 0,
+      "resources": [],
+      "locationObject": null,
+      "locationObjectResolved": true,
+      "createdUtc": "string (ISO-8601 datetime)"
+    }
+  }
+  ```