Add support for dedicated_for parameter in update_access_key Provisioning API

Author: const-cloudinary

cloudinary/provisioning/account.py

@@ -425,7 +425,7 @@ def generate_access_key(sub_account_id, name=None, enabled=None, **options):
     return _call_account_api("post", uri, params, **options)
 
 
-def update_access_key(sub_account_id, api_key, name=None, enabled=None, **options):
+def update_access_key(sub_account_id, api_key, name=None, enabled=None, dedicated_for=None, **options):
     """
     Update the name and/or status of an existing access key.
 
@@ -437,6 +437,10 @@ def update_access_key(sub_account_id, api_key, name=None, enabled=None, **option
     :type name:                 str
     :param enabled:             Enable or disable the access key.
     :type enabled:              bool
+    :param dedicated_for:       Designates the access key for a specific purpose while allowing it to be used for
+                                other purposes, as well. This action replaces any previously assigned key.
+                                **Possible values**: `webhooks`
+    :type dedicated_for:        str
     :param options:             Generic advanced options dict, see online documentation.
     :type options:              dict, optional
     :return:                    Access key details
@@ -446,6 +450,7 @@ def update_access_key(sub_account_id, api_key, name=None, enabled=None, **option
     params = {
         "name": name,
         "enabled": enabled,
+        "dedicated_for": dedicated_for,
     }
     return _call_account_api("put", uri, params, **options)
 

test/test_provisioning_api.py

@@ -230,16 +230,18 @@ def test_update_access_key(self):
         key_name = UNIQUE_TEST_ID + "_before_update_test_key"
         updated_key_name = UNIQUE_TEST_ID + "_updated_test_key"
 
-        key_res = cloudinary.provisioning.generate_access_key(self.cloud_id, name=key_name, enabled=True)
+        key_res = cloudinary.provisioning.generate_access_key(self.cloud_id, name=key_name, enabled=False)
 
         self.assertEqual(key_name, key_res["name"])
-        self.assertEqual(True, key_res["enabled"])
+        self.assertEqual(False, key_res["enabled"])
 
         res = cloudinary.provisioning.update_access_key(self.cloud_id, key_res["api_key"],
-                                                        name=updated_key_name, enabled=False)
+                                                        name=updated_key_name, enabled=True, dedicated_for="webhooks")
 
         self.assertEqual(updated_key_name, res["name"])
-        self.assertEqual(False, res["enabled"])
+        self.assertEqual(True, res["enabled"])
+        self.assertEqual(1, len(res["dedicated_for"]))
+        self.assertEqual("webhooks", res["dedicated_for"][0])
 
     @unittest.skipUnless(cloudinary.provisioning.account_config().provisioning_api_secret,
                          "requires provisioning_api_key/provisioning_api_secret")