diff --git a/registry/components/auth_oauth2/component.contract.yaml b/registry/components/auth_oauth2/component.contract.yaml
index d0b726a..0723647 100644
--- a/registry/components/auth_oauth2/component.contract.yaml
+++ b/registry/components/auth_oauth2/component.contract.yaml
@@ -27,7 +27,11 @@ input_schema:
         refresh — 強制重新 refresh，更新 CREDENTIALS_KV 中的 access_token/expires_at
     api_key:
       type: string
-      description: 租戶識別（ak_ 前綴），用來組 {api_key}:cred:{name} KV key
+      description: >-
+        租戶識別＝Arcrun namespace，用來組 {api_key}:cred:{name} KV key。
+        ⚠️ 2026-07-29 更正：舊敘述寫「ak_ 前綴」，但現行沒有發 API key 的機制
+        （leo 07-29 指正）——namespace 即身分即憑證。下方 examples 的 ak_test/ak_nonexistent
+        是測試用假值，不代表真實格式。
     service:
       type: string
       description: auth recipe 名稱，對應 auth_recipe:{service} 的 KV 記錄
diff --git a/registry/components/auth_service_account/component.contract.yaml b/registry/components/auth_service_account/component.contract.yaml
index b778ed2..92145eb 100644
--- a/registry/components/auth_service_account/component.contract.yaml
+++ b/registry/components/auth_service_account/component.contract.yaml
@@ -24,7 +24,11 @@ input_schema:
       description: 目前僅支援 authenticate
     api_key:
       type: string
-      description: 租戶識別(ak_ 前綴),用來組 {api_key}:cred:{name} KV key
+      description: >-
+        租戶識別＝Arcrun namespace，用來組 {api_key}:cred:{name} KV key。
+        ⚠️ 2026-07-29 更正：舊敘述寫「ak_ 前綴」，但現行沒有發 API key 的機制
+        （leo 07-29 指正）——namespace 即身分即憑證。下方 examples 的 ak_test/ak_nonexistent
+        是測試用假值，不代表真實格式。
     service:
       type: string
       description: auth recipe 名稱,對應 auth_recipe:{service} 的 KV 記錄
diff --git a/registry/components/auth_static_key/component.contract.yaml b/registry/components/auth_static_key/component.contract.yaml
index de2a028..a23ec2c 100644
--- a/registry/components/auth_static_key/component.contract.yaml
+++ b/registry/components/auth_static_key/component.contract.yaml
@@ -24,7 +24,11 @@ input_schema:
       description: 目前僅支援 authenticate;static_key 無 refresh 概念
     api_key:
       type: string
-      description: 租戶識別(ak_ 前綴),用來組 {api_key}:cred:{name} KV key
+      description: >-
+        租戶識別＝Arcrun namespace，用來組 {api_key}:cred:{name} KV key。
+        ⚠️ 2026-07-29 更正：舊敘述寫「ak_ 前綴」，但現行沒有發 API key 的機制
+        （leo 07-29 指正）——namespace 即身分即憑證。下方 examples 的 ak_test/ak_nonexistent
+        是測試用假值，不代表真實格式。
     service:
       type: string
       description: auth recipe 名稱,對應 auth_recipe:{service} 的 KV 記錄
diff --git a/registry/components/kbdb_upsert_block/component.contract.yaml b/registry/components/kbdb_upsert_block/component.contract.yaml
index 533ae3f..1adf546 100644
--- a/registry/components/kbdb_upsert_block/component.contract.yaml
+++ b/registry/components/kbdb_upsert_block/component.contract.yaml
@@ -20,7 +20,12 @@ input_schema:
   properties:
     api_key:
       type: string
-      description: KBDB partner key（ak_xxx）
+      description: >-
+        租戶識別＝Arcrun namespace（送出時放 X-Arcrun-API-Key header）。
+        ⚠️ 2026-07-29 更正：舊敘述寫「KBDB partner key（ak_xxx）」，但**現行沒有發
+        API key 的機制**（leo 07-29 指正）——namespace 即身分即憑證。
+        workflow 裡一律寫 {{credential.arcrun_namespace}}，值由執行期解析（D36）。
+        欄位名維持 api_key（改名會破壞現有 workflow），只是它裝的是 namespace。
     page_name:
       type: string
       description: 當 idempotency key。內部用 GET /blocks?page_name= 查找。