diff --git a/docs/swagger/definitions/DeviceLongUrls.json b/docs/swagger/definitions/DeviceLongUrls.json
index 25e7f322..1a56d9ef 100644
--- a/docs/swagger/definitions/DeviceLongUrls.json
+++ b/docs/swagger/definitions/DeviceLongUrls.json
@@ -4,17 +4,17 @@
         "android": {
             "description": "The long URL to redirect to when the short URL is visited from a device running Android",
             "type": "string",
-            "nullable": true
+            "nullable": false
         },
         "ios": {
             "description": "The long URL to redirect to when the short URL is visited from a device running iOS",
             "type": "string",
-            "nullable": true
+            "nullable": false
         },
         "desktop": {
             "description": "The long URL to redirect to when the short URL is visited from a desktop browser",
             "type": "string",
-            "nullable": true
+            "nullable": false
         }
     }
 }
diff --git a/docs/swagger/definitions/DeviceLongUrlsEdit.json b/docs/swagger/definitions/DeviceLongUrlsEdit.json
new file mode 100644
index 00000000..78f77e46
--- /dev/null
+++ b/docs/swagger/definitions/DeviceLongUrlsEdit.json
@@ -0,0 +1,17 @@
+{
+    "type": "object",
+    "allOf": [{
+        "$ref": "./DeviceLongUrls.json"
+    }],
+    "properties": {
+        "android": {
+            "nullable": true
+        },
+        "ios": {
+            "nullable": true
+        },
+        "desktop": {
+            "nullable": true
+        }
+    }
+}
diff --git a/docs/swagger/definitions/DeviceLongUrlsResp.json b/docs/swagger/definitions/DeviceLongUrlsResp.json
index 64a56c01..95724581 100644
--- a/docs/swagger/definitions/DeviceLongUrlsResp.json
+++ b/docs/swagger/definitions/DeviceLongUrlsResp.json
@@ -2,6 +2,6 @@
     "type": "object",
     "required": ["android", "ios", "desktop"],
     "allOf": [{
-        "$ref": "./DeviceLongUrls.json"
+        "$ref": "./DeviceLongUrlsEdit.json"
     }]
 }
diff --git a/docs/swagger/definitions/ShortUrlEdition.json b/docs/swagger/definitions/ShortUrlEdition.json
index 7a9aca7b..28fa71bc 100644
--- a/docs/swagger/definitions/ShortUrlEdition.json
+++ b/docs/swagger/definitions/ShortUrlEdition.json
@@ -6,7 +6,7 @@
             "type": "string"
         },
         "deviceLongUrls": {
-            "$ref": "./DeviceLongUrls.json"
+            "$ref": "./DeviceLongUrlsEdit.json"
         },
         "validSince": {
             "description": "The date (in ISO-8601 format) from which this short code will be valid",
diff --git a/docs/swagger/paths/v1_short-urls.json b/docs/swagger/paths/v1_short-urls.json
index 12afe6f4..76d87659 100644
--- a/docs/swagger/paths/v1_short-urls.json
+++ b/docs/swagger/paths/v1_short-urls.json
@@ -296,6 +296,9 @@
                                 "type": "object",
                                 "required": ["longUrl"],
                                 "properties": {
+                                    "deviceLongUrls": {
+                                        "$ref": "../definitions/DeviceLongUrls.json"
+                                    },
                                     "customSlug": {
                                         "description": "A unique custom slug to be used instead of the generated short code",
                                         "type": "string"
diff --git a/docs/swagger/paths/v1_short-urls_shorten.json b/docs/swagger/paths/v1_short-urls_shorten.json
index bf2889e5..cacb00bb 100644
--- a/docs/swagger/paths/v1_short-urls_shorten.json
+++ b/docs/swagger/paths/v1_short-urls_shorten.json
@@ -6,7 +6,7 @@
             "Short URLs"
         ],
         "summary": "Create a short URL",
-        "description": "Creates a short URL in a single API call. Useful for third party integrations.",
+        "description": "**[Deprecated]** Use [Create short URL](#/Short%20URLs/createShortUrl) instead",
         "parameters": [
             {
                 "$ref": "../parameters/version.json"