linode · Dorthu · Apr 2, 2018 · Mar 19, 2018 · Mar 19, 2018 · Mar 20, 2018
diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@
 </h1>
 
 This is the new Linode developers site. It provides documentation to complement the APIv4.
-Currently this software is *early-access* and is available at [developers.linode.com](https://developers.linode.com).
+This documentation can be viewed at [developers.linode.com](https://developers.linode.com).
 
 ## Setup
 

diff --git a/src/App.js b/src/App.js
@@ -148,7 +148,7 @@ browserHistory.listen(function (location) {
 
 window.setTitle = function (newTitle) {
   const title = document.querySelector('title');
-  title.textContent = 'API v4 Documentation | Linode Developers';
+  title.textContent = 'API Documentation | Linode Developers';
 
   if (newTitle) {
     title.textContent = `${newTitle} | ${title.textContent}`;

diff --git a/src/data/endpoints/account.yaml b/src/data/endpoints/account.yaml
@@ -185,7 +185,7 @@ endpoints:
           python: |
             my_client = linode.OAuthClient(client, 123)
             my_client.delete()
-  /account/oauth-clients/$id/reset_secret:
+  /account/oauth-clients/$id/reset-secret:
     group: OAuth Clients
     type: Action
     authenticated: true
@@ -200,7 +200,7 @@ endpoints:
             curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \
                 -X POST \
-                https://$api_root/$version/account/oauth-clients/$client_id/reset_secret
+                https://$api_root/$version/account/oauth-clients/$client_id/reset-secret
           python: |
             my_client = linode.OAuthClient(client, 123)
             new_secret = my_client.reset_secret()
@@ -269,10 +269,6 @@ endpoints:
             type: String
             description: The user's email.
             value: [email protected]
-          password:
-            type: String
-            description: The user's password.
-            value: hunter2
           restricted:
             optional: true
             type: Boolean
@@ -284,7 +280,6 @@ endpoints:
                 -H "Authorization: Bearer $TOKEN" \
                 -X POST -d '{
                     "username": "testguy",
-                    "password": "hunter7",
                     "email": "[email protected]"
                 }' \
                 https://$api_root/$version/account/users
@@ -311,13 +306,13 @@ endpoints:
             curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \
                 -X PUT -d '{
-                    "email": "[email protected]"
+                    "username": "newusername"
                   }
                 }' \
                 https://$api_root/$version/account/users/testguy
           python: |
             my_user = linode.User(client, 'username')
-            my_user.email = '[email protected]'
+            my_user.username = 'newusername'
             my_user.save()
       DELETE:
         description: >

diff --git a/src/data/endpoints/domains.yaml b/src/data/endpoints/domains.yaml
@@ -264,7 +264,7 @@ endpoints:
               The tag attribute for a CAA record. One of "issue", "issuewild",
               or "iodef". Ignored on other record types.
             type: Enum
-          ttl:
+          ttl_sec:
             optional: true
             description: >
               Time interval that the resource record may be cached before

diff --git a/src/data/endpoints/linodes.yaml b/src/data/endpoints/linodes.yaml
@@ -281,18 +281,6 @@ endpoints:
           python: |
             disk.label = 'New Disk Label'
             disk.save()
-      POST:
-        oauth: linodes:create
-        description: >
-          Duplicates this disk.
-        examples:
-          curl: |
-            curl -H "Content-Type: application/json" \
-                -H "Authorization: Bearer $TOKEN" \
-                -X POST \
-                https://$api_root/$version/linode/instances/$linode_id/disks/$disk_id
-          python: |
-            new_disk = disk.duplicate()
       DELETE:
         oauth: linodes:delete
         dangerous: true
@@ -305,6 +293,25 @@ endpoints:
                 https://$api_root/$version/linode/instances/$linode_id/disks/$disk_id
           python: |
             disk.delete()
+  /linode/instances/$id/disks/$id/clone:
+    group: Disks
+    type: resource
+    authenticated: true
+    description: >
+      Duplicates a disk.
+    methods:
+      POST:
+        oauth: linodes:create
+        description: >
+          Duplicates this disk.
+        examples:
+          curl: |
+            curl -H "Content-Type: application/json" \
+                -H "Authorization: Bearer $TOKEN" \
+                -X POST \
+                https://$api_root/$version/linode/instances/$linode_id/disks/$disk_id/clone
+          python: |
+            new_disk = disk.duplicate()
   /linode/instances/$id/disks/$id/resize:
     group: Disks
     type: Strange
@@ -869,23 +876,27 @@ endpoints:
         money: true
         oauth: linodes:modify
         description: >
-          Allocates a new IP Address for this Linode.
+          Allocates a new IPv4 Address for this Linode.
         params:
           type:
-            description: >
-                The type of IP Address this is, can be one of "public" or "private".
-                Public IP Addresses, over and above the one included with each Linode,
-                incur an additional monthly charge. If you need an additional Public IP Address
-                you must request one - please open a ticket.
             type: String
-            value: private
+            description: >
+              The type of IP to allocate.  Currently only "ipv4" is supported.
+            value: ipv4
+          public:
+            type: Boolean
+            description: >
+              Whether this is a public or private IP address.
+              Public IP Addresses, over and above the one included with each
+              Linode, incur an additional monthly charge. If you need an
+              additional Public IP Address you must request one - please
+              open a ticket.
+            value: true
         examples:
           curl: |
             curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \
-                -X POST -d '{
-                    "type": "private"
-                }' \
+                -X POST -d '{"type": "ipv4", "public":true}' \
                 https://$api_root/$version/linode/instances/$linode_id/ips
   /linode/instances/$id/ips/$ip_address:
     group: IPs
@@ -929,8 +940,7 @@ endpoints:
     authenticated: true
     description: >
       Deletes all Disks and Configs on this Linode, then deploys a new
-      Distribution or Image to this Linode with the given attributes. Returns
-      a JSON object representation of the Linode's disks and configs.
+      Distribution or Image to this Linode with the given attributes.
     methods:
       POST:
         oauth: linodes:modify

diff --git a/src/data/endpoints/managed.yaml b/src/data/endpoints/managed.yaml
@@ -394,7 +394,7 @@ endpoints:
             curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \
                 https://$api_root/$version/managed/credentials/$credential_id/revoke
-  /managed/linode_settings:
+  /managed/linode-settings:
     group: Linode Settings
     type: resource
     authenticated: true
@@ -408,8 +408,8 @@ endpoints:
         examples:
           curl: |
             curl -H "Authorization: Bearer $TOKEN" \
-                https://$api_root/$version/managed/linode_settings
-  /managed/linode_settings/$id:
+                https://$api_root/$version/managed/linode-settings
+  /managed/linode-settings/$id:
     group: Linode Settings
     type: resource
     authenticated: true
@@ -423,7 +423,7 @@ endpoints:
         examples:
           curl: |
             curl -H "Authorization: Bearer $TOKEN" \
-                https://$api_root/$version/managed/linode_settings/$linode_settings_id
+                https://$api_root/$version/managed/linode-settings/$linode_settings_id
       PUT:
         response: ManagedLinodeSetting
         description: >
@@ -440,7 +440,7 @@ endpoints:
                     "access": true
                   }
                 }' \
-                https://$api_root/$version/managed/linode_settings/$linode_settings_id
+                https://$api_root/$version/managed/linode-settings/$linode_settings_id
   /managed/stats:
     group: Stats
     type: Action

diff --git a/src/data/endpoints/networking.yaml b/src/data/endpoints/networking.yaml
@@ -15,30 +15,43 @@ endpoints:
         paginationKey: data
         oauth: ips:view
         description: >
-          Returns a list of IP Addresses, including v4 and slaac addresses.
+          Returns a list of IP Addresses, including v4, slaac, and public v6
+          addresses.
         examples:
           curl: |
             curl -H "Authorization: Bearer $TOKEN" \
               https://$api_root/$version/networking/ips
       POST:
+        response: ipaddress
         money: true
         oauth: ips:create
         description: >
-          Create a new Public IPv4 Address.
+          Create a new IPv4 Address.
         params:
           type:
             type: String
             description: >
-              The type of IP to allocate.  Currently only "ipv4" is supported.
+              The type of IP to allocate. Currently only "ipv4" is supported.
+            value: ipv4
+          public:
+            type: Boolean
+            description: >
+              Whether this is a public or private IP address.
+              Public IP Addresses, over and above the one included with each
+              Linode, incur an additional monthly charge. If you need an
+              additional Public IP Address you must request one - please
+              open a ticket.
+            value: true
           linode_id:
+            type: Integer
             description: >
               The Linode ID to assign this IP to.
-            type: Integer
+            value: 123
         examples:
           curl: |
             curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \
-                -X POST -d '{"type":"ipv4","linode":123}' \
+                -X POST -d '{"type":"ipv4", "public":true, "linode":123}' \
                 https://$api_root/$version/networking/ips
   /networking/ips/$address:
     group: IPs
@@ -116,39 +129,7 @@ endpoints:
                 https://$api_root/$version/networking/ipv6/ranges
           python: |
             my_ipv6s = client.networking.get_ipv6_ranges()
-  /networking/ipv6/$address:
-    group: IPv6
-    type: resource
-    authenticated: true
-    description: >
-      Manage a single IPv6 Address.  Address in URL
-      can be as compressed as you want.
-    methods:
-      GET:
-        response: ipv6-address
-        oauth: ips:view
-        description: >
-          Return a single IPv6 Address.
-        examples:
-          curl: |
-            curl -H "Authorization: Bearer $TOKEN" \
-                https://$api_root/$version/networking/ipv6/2600:3c01::2:5001
-          python: |
-            my_ipv6 = linode.IPv6Address(client, '2600:3c01::2:5001')
-      PUT:
-        oauth: ips:modify
-        description: >
-          Set RDNS on a single IPv6 Address.
-        examples:
-          curl: |
-            curl -H "Content-Type: application/json" \
-                -H "Authorization: Bearer $TOKEN" \
-                -X PUT -d '{"rdns":"example.org"}' \
-                https://$api_root/$version/networking/ipv6/2600:3c01::2:5001
-          python: |
-            my_ipv6.rdns = 'example.org'
-            my_ipv6.save()
-  /networking/ip-assign:
+  /networking/ipv4/assign:
     group: IPv4
     type: Strange
     authenticated: true
@@ -183,7 +164,7 @@ endpoints:
             curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \
                 -X POST -d '$SUB_SPEC_EXAMPLE' \
-            https://$api_root/$version/networking/ip-assign
+            https://$api_root/$version/networking/ipv4/assign
           python: |
             linode_1 = linode.Linode(client, 134504)
             ip1 = linode_1.ips.ipv4.public[0]
@@ -192,7 +173,7 @@ endpoints:
             ip2 = linode_2.ips.ipv4.public[0]
 
             client.networking.assign_ips(linode_1.region, ip1.to(linode_2), ip2.to(linode_1))
-  /networking/ip-sharing:
+  /networking/ipv4/share:
     group: IPv4
     type: Strange
     authenticated: true
@@ -220,5 +201,5 @@ endpoints:
                   "linode_id": 12345,
                   "ips": [ "97.107.143.29", "97.107.143.112" ]
                 }' \
-                https://$api_root/$version/networking/ip-sharing
+                https://$api_root/$version/networking/ipv4/share
 
diff --git a/src/data/endpoints/support.yaml b/src/data/endpoints/support.yaml
@@ -62,22 +62,6 @@ endpoints:
               The Block Storage Volume this ticket is regarding, if relevant.
             type: Integer
             optional: true
-          managed_issue_type:
-            description: >
-              The Managed issue type of this ticket. Do not pass this
-              unless your account has Managed Services activated.
-            type: Enum
-            value: issue
-            maintenance:
-              type: String
-              description: Maintenance
-            issue:
-              type: String
-              description: An issue
-            request:
-              type: String
-              description: Other request
-            optional: true
           curl: |
             curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \

diff --git a/src/data/objects/ipaddress.yaml b/src/data/objects/ipaddress.yaml
@@ -1,6 +1,6 @@
 name: IP Address
 description: >
-    An IP Address
+    An IPv4 Address
 schema:
   address:
     type: String
@@ -26,16 +26,19 @@ schema:
   region:
     type: String
     value: us-east
-    description: The region this IP is in.
+    description: The Region this IP is in.
   subnet_mask:
     type: String
     value: 255.255.255.0
     description: The subnet mask.
+  public:
+    type: Boolean
+    value: true
+    description: Whether this is a public or private IP address.
   type:
-    type: Enum
-    subtype: IPAddressType
-    value: public
-    description: The type of IP Address, either public or private.
+    type: String
+    description: The type of IP Address.
+    value: ipv4
 enums:
   IPAddressType:
     public: Public IP Address.