Update updating.rst

docs/data/updating.rst

@@ -126,3 +126,119 @@ Example Result
 
 429 : Too many request
    * You have either hit your API or Database limit. Please review your account.
+
+````
+Many
+````
+
+Bulk update data based on provided filter.
+
+.. tabs::
+
+   .. group-tab:: C#
+
+      .. code-block:: c#
+
+         var client = MeshyClient.Initialize(accountName, publicKey);
+         var connection = await client.LoginAnonymouslyAsync(username);
+
+         var result = await connection.Meshes.UpdateManyAsync<Person>(filter, update);
+
+      |parameters|
+
+      accountName : :type:`string`, :required:`required`
+         Indicates which account you are connecting to.
+      publicKey : :type:`string`, :required:`required`
+         Public identifier of connecting service.
+      username : :type:`string`, :required:`required`
+         Unique user name for authentication.
+      mesh : :type:`string`, :required:`required`, default: class name
+         Identifies name of mesh collection. e.g. person.
+      filter : :type:`string`, :required:`required`
+         Criteria provided in a MongoDB format to limit results.
+      update : :type:`string`, :required:`required`
+         Update command provided in a MongoDB format.
+
+   .. group-tab:: NodeJS
+
+      .. code-block:: javascript
+
+         var client = MeshyClient.initialize(accountName, publicKey);         
+         var anonymousUser = await client.registerAnonymousUser();
+         var connection = await client.loginAnonymously(anonymousUser.username);
+
+         var result = await connection.meshesService.updateMany(meshName, filter, update);
+
+      |parameters|
+
+      accountName : :type:`string`, :required:`required`
+         Indicates which account you are connecting to.
+      publicKey : :type:`string`, :required:`required`
+         Public identifier of connecting service.
+      username : :type:`string`, :required:`required`
+         Unique user name for authentication.
+      meshName : :type:`string`, :required:`required`
+         Identifies name of mesh collection. e.g. person.
+      filter : :type:`string`, :required:`required`
+         Criteria provided in a MongoDB format to limit results.
+      update : :type:`string`, :required:`required`
+         Update command provided in a MongoDB format.
+
+   .. group-tab:: REST
+
+      .. code-block:: http
+
+         PATCH https://api.meshydb.com/{accountName}/meshes/{mesh}  HTTP/1.1
+         Authorization: Bearer {access_token}
+         Content-Type: application/json
+
+         {
+            "filter": filter,
+            "update": update
+         }
+
+      |parameters|
+
+      accountName : :type:`string`, :required:`required`
+         Indicates which account you are connecting to.
+      access_token : :type:`string`, :required:`required`
+         Token identifying authorization with MeshyDB requested during `Generating Token <../authorization/generating_token.html#generating-token>`_.
+      mesh : :type:`string`, :required:`required`
+         Identifies name of mesh collection. e.g. person.
+      filter : :type:`string`, :required:`required`
+         Criteria provided in a MongoDB format to limit results.
+      update : :type:`string`, :required:`required`
+         Update command provided in a MongoDB format.
+
+.. rubric:: Responses
+
+200 : OK
+   * Result of updated mesh data.
+
+Example Result
+
+.. code-block:: json
+
+   {
+      "isAcknowledged": true,
+      "isModifiedCountAvailable": true,
+      "matchedCount": 5,
+      "modifiedCount": 3,
+      "upsertedId": null
+   }
+
+400 : Bad request
+   * Mesh name is invalid and must be alpha characters only.
+   * Filter is required.
+   * Update is required.
+   * Filter is in an invalid format. It must be in a valid Mongo DB format.
+   * Update is in an invalid format. It must be in a valid Mongo DB format.
+
+401 : Unauthorized
+   * User is not authorized to make call.
+
+403 : Forbidden
+   * User has insufficent permission to update meshes or mesh.
+
+429 : Too many request
+   * You have either hit your API or Database limit. Please review your account.