From c2cd5fa8cff1c5daac7afbee099dfda1d38c0937 Mon Sep 17 00:00:00 2001
From: Travis Prescott <trpresco@microsoft.com>
Date: Thu, 4 Jun 2026 12:30:20 -0700
Subject: [PATCH 1/2] [API Review] API.md for azure-keyvault-keys 4.12.0b3

---
 sdk/keyvault/azure-keyvault-keys/API.md       | 42 +++++++++++++++++++
 .../azure-keyvault-keys/API.metadata.yml      |  2 +-
 2 files changed, 43 insertions(+), 1 deletion(-)

diff --git a/sdk/keyvault/azure-keyvault-keys/API.md b/sdk/keyvault/azure-keyvault-keys/API.md
index 4909d2fffbdb..ed1309032a31 100644
--- a/sdk/keyvault/azure-keyvault-keys/API.md
+++ b/sdk/keyvault/azure-keyvault-keys/API.md
@@ -4,6 +4,7 @@ namespace azure.keyvault.keys
     class azure.keyvault.keys.ApiVersion(str, Enum, metaclass=CaseInsensitiveEnumMeta):
         V2016_10_01 = "2016-10-01"
         V2025_07_01 = "2025-07-01"
+        V2026_01_01_PREVIEW = "2026-01-01-preview"
         V7_0 = "7.0"
         V7_1 = "7.1"
         V7_2 = "7.2"
@@ -36,6 +37,17 @@ namespace azure.keyvault.keys
         def __repr__(self) -> str: ...
 
 
+    class azure.keyvault.keys.ExternalKey:
+
+        def __init__(
+                self, 
+                *, 
+                id: str
+            ) -> None: ...
+
+        def __repr__(self) -> str: ...
+
+
     class azure.keyvault.keys.JsonWebKey:
 
         def __init__(
@@ -132,6 +144,20 @@ namespace azure.keyvault.keys
                 **kwargs: Any
             ) -> KeyVaultKey: ...
 
+        @distributed_trace
+        def create_external_key(
+                self, 
+                name: str, 
+                external_key: ExternalKey, 
+                *, 
+                enabled: Optional[bool] = ..., 
+                expires_on: Optional[datetime] = ..., 
+                not_before: Optional[datetime] = ..., 
+                release_policy: Optional[KeyReleasePolicy] = ..., 
+                tags: Optional[Dict[str, str]] = ..., 
+                **kwargs: Any
+            ) -> KeyVaultKey: ...
+
         @distributed_trace
         def create_key(
                 self, 
@@ -359,8 +385,10 @@ namespace azure.keyvault.keys
         property enabled: Optional[bool]    # Read-only
         property expires_on: Optional[datetime]    # Read-only
         property exportable: Optional[bool]    # Read-only
+        property external_key: Optional[ExternalKey]    # Read-only
         property hsm_platform: Optional[str]    # Read-only
         property id: str    # Read-only
+        property key_size: Optional[int]    # Read-only
         property managed: Optional[bool]    # Read-only
         property name: str    # Read-only
         property not_before: Optional[datetime]    # Read-only
@@ -508,6 +536,20 @@ namespace azure.keyvault.keys.aio
                 **kwargs: Any
             ) -> KeyVaultKey: ...
 
+        @distributed_trace_async
+        async def create_external_key(
+                self, 
+                name: str, 
+                external_key: ExternalKey, 
+                *, 
+                enabled: Optional[bool] = ..., 
+                expires_on: Optional[datetime] = ..., 
+                not_before: Optional[datetime] = ..., 
+                release_policy: Optional[KeyReleasePolicy] = ..., 
+                tags: Optional[Dict[str, str]] = ..., 
+                **kwargs: Any
+            ) -> KeyVaultKey: ...
+
         @distributed_trace_async
         async def create_key(
                 self, 
diff --git a/sdk/keyvault/azure-keyvault-keys/API.metadata.yml b/sdk/keyvault/azure-keyvault-keys/API.metadata.yml
index fe71aa154eb2..b56a2efe4af0 100644
--- a/sdk/keyvault/azure-keyvault-keys/API.metadata.yml
+++ b/sdk/keyvault/azure-keyvault-keys/API.metadata.yml
@@ -1,3 +1,3 @@
-apiMdSha256: 81afb80fc423bf72aca4bf217228bd93c2b2215c37ae30f15d4c2ec0690922a2
+apiMdSha256: 05e3c49b61c87d61acec04ec97bd251f05ed4d256c62153c9905d4cad25dd6da
 parserVersion: 0.3.28
 pythonVersion: 3.11.4

From 492a35cf1a846c4c4cc8bd966f42bdd6bbe32bf2 Mon Sep 17 00:00:00 2001
From: Travis Prescott <trpresco@microsoft.com>
Date: Thu, 4 Jun 2026 14:17:57 -0700
Subject: [PATCH 2/2] Add fake docstring for testing.

---
 sdk/keyvault/azure-keyvault-keys/API.md           | 6 ++++++
 sdk/keyvault/azure-keyvault-keys/API.metadata.yml | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/sdk/keyvault/azure-keyvault-keys/API.md b/sdk/keyvault/azure-keyvault-keys/API.md
index ed1309032a31..aa08a053a8e1 100644
--- a/sdk/keyvault/azure-keyvault-keys/API.md
+++ b/sdk/keyvault/azure-keyvault-keys/API.md
@@ -38,6 +38,12 @@ namespace azure.keyvault.keys
 
 
     class azure.keyvault.keys.ExternalKey:
+        # A key that is managed outside Azure Key Vault.
+        # External keys reference key material stored by an external key manager,
+        # allowing Key Vault operations to identify and use that external key by id.
+        # A key that is managed outside Azure Key Vault.
+        # External keys reference key material stored by an external key manager,
+        # allowing Key Vault operations to identify and use that external key by id.
 
         def __init__(
                 self, 
diff --git a/sdk/keyvault/azure-keyvault-keys/API.metadata.yml b/sdk/keyvault/azure-keyvault-keys/API.metadata.yml
index b56a2efe4af0..a35172c25a2e 100644
--- a/sdk/keyvault/azure-keyvault-keys/API.metadata.yml
+++ b/sdk/keyvault/azure-keyvault-keys/API.metadata.yml
@@ -1,3 +1,3 @@
-apiMdSha256: 05e3c49b61c87d61acec04ec97bd251f05ed4d256c62153c9905d4cad25dd6da
+apiMdSha256: 62270a2145e6cec059c90c07ca0ec87d665bd6c0d0f6d5fff967d1832ac363aa
 parserVersion: 0.3.28
 pythonVersion: 3.11.4