diff --git a/lib/wanderer_app_web/controllers/map_connection_api_controller.ex b/lib/wanderer_app_web/controllers/map_connection_api_controller.ex
index 20e39775..2c9c162a 100644
--- a/lib/wanderer_app_web/controllers/map_connection_api_controller.ex
+++ b/lib/wanderer_app_web/controllers/map_connection_api_controller.ex
@@ -135,7 +135,7 @@ defmodule WandererAppWeb.MapConnectionAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "map-slug or map UUID"
       ],
       solar_system_source: [in: :query, type: :integer, required: false],
       solar_system_target: [in: :query, type: :integer, required: false]
@@ -190,7 +190,7 @@ defmodule WandererAppWeb.MapConnectionAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "map-slug or map UUID"
       ],
       id: [in: :path, type: :string, required: false],
       solar_system_source: [in: :query, type: :integer, required: false],
@@ -221,7 +221,7 @@ defmodule WandererAppWeb.MapConnectionAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "map-slug or map UUID"
       ],
       system_id: [in: :path, type: :string, required: false]
     ],
@@ -259,7 +259,7 @@ defmodule WandererAppWeb.MapConnectionAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "map-slug or map UUID"
       ],
       id: [in: :path, type: :string, required: false],
       solar_system_source: [in: :query, type: :integer, required: false],
@@ -347,7 +347,7 @@ defmodule WandererAppWeb.MapConnectionAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "map-slug or map UUID"
       ],
       id: [in: :path, type: :string, required: false],
       solar_system_source: [in: :query, type: :integer, required: false],
diff --git a/lib/wanderer_app_web/controllers/map_system_api_controller.ex b/lib/wanderer_app_web/controllers/map_system_api_controller.ex
index a89cff92..6cc91911 100644
--- a/lib/wanderer_app_web/controllers/map_system_api_controller.ex
+++ b/lib/wanderer_app_web/controllers/map_system_api_controller.ex
@@ -293,7 +293,7 @@ defmodule WandererAppWeb.MapSystemAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "my-map-slug or map UUID"
       ]
     ],
     responses: [
@@ -317,7 +317,7 @@ defmodule WandererAppWeb.MapSystemAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "my-map-slug or map UUID"
       ],
       id: [in: :path, type: :string, required: true]
     ],
@@ -337,7 +337,7 @@ defmodule WandererAppWeb.MapSystemAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "my-map-slug or map UUID"
       ]
     ],
     request_body: {"Systems+Connections upsert", "application/json", @batch_request_schema},
@@ -361,7 +361,7 @@ defmodule WandererAppWeb.MapSystemAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "my-map-slug or map UUID"
       ],
       id: [in: :path, type: :string, required: true]
     ],
@@ -384,7 +384,7 @@ defmodule WandererAppWeb.MapSystemAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "my-map-slug or map UUID"
       ]
     ],
     request_body: {"Batch delete", "application/json", @batch_delete_schema},
@@ -431,7 +431,7 @@ defmodule WandererAppWeb.MapSystemAPIController do
         description: "Map identifier (UUID or slug). Provide either a UUID or a slug.",
         type: :string,
         required: true,
-        example: "00000000-0000-0000-0000-000000000000 or my-map-slug"
+        example: "my-map-slug or map UUID"
       ],
       id: [in: :path, type: :string, required: true]
     ],