diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/examples/PutUserAssignedIdentity.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/examples/PutUserAssignedIdentity.json
new file mode 100644
index 000000000000..2882d8b64f89
--- /dev/null
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/examples/PutUserAssignedIdentity.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "location": "{location}",
+    "identity": {
+      "type": "UserAssigned",
+      "userAssignedIdentities": {
+        "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/00000000": {},
+        "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/00000001": {}
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "subscriptions/{subscriptionId}/resourcegroups/myResourceGroup/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}",
+        "location": "{location}",
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/00000000/providers/Microsoft.ManagedIdentity/userAssignedIdentities/00000000": {
+              "principalId": "00000000-0000-0000-0000-000000000000",
+              "clientId": "00000000-0000-0000-0000-000000000000"
+            },
+            "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/00000001/providers/Microsoft.ManagedIdentity/userAssignedIdentities/00000001": {
+              "principalId": "00000000-0000-0000-0000-000000000000",
+              "clientId": "00000000-0000-0000-0000-000000000000"
+            }
+          }
+        }
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/resources.json
index 6e92011f07e7..a7e151e31f06 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/resources.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/resources.json
@@ -2952,6 +2952,25 @@
             "name": "ResourceIdentityType",
             "modelAsString": false
           }
+        },
+        "userAssignedIdentities": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "principalId": {
+                "readOnly": true,
+                "type": "string",
+                "description": "The principal id of user assigned identity."
+              },
+              "clientId": {
+                "readOnly": true,
+                "type": "string",
+                "description": "The client id of user assigned identity."
+              }
+            }
+          },
+          "description": "The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'."
         }
       },
       "description": "Identity for the resource."