Rename vault describe_object to get_object_metadata

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: gjtorikian

src/workos/vault.py

@@ -302,7 +302,7 @@ def read_object_by_name(self, *, name: str) -> VaultObject:
         )
         return response
 
-    def describe_object(self, *, object_id: str) -> VaultObject:
+    def get_object_metadata(self, *, object_id: str) -> VaultObject:
         """Get a Vault object's metadata without decrypting the value."""
         response = self._client.request(
             method="get",
@@ -484,7 +484,7 @@ async def read_object_by_name(self, *, name: str) -> VaultObject:
         )
         return response
 
-    async def describe_object(self, *, object_id: str) -> VaultObject:
+    async def get_object_metadata(self, *, object_id: str) -> VaultObject:
         response = await self._client.request(
             method="get",
             path=f"vault/v1/kv/{object_id}/metadata",

tests/test_vault.py

@@ -44,9 +44,9 @@ def test_read_object_by_name(self, workos, httpx_mock):
         assert request.method == "GET"
         assert request.url.path.endswith("/vault/v1/kv/name/my-secret")
 
-    def test_describe_object(self, workos, httpx_mock):
+    def test_get_object_metadata(self, workos, httpx_mock):
         httpx_mock.add_response(json=load_fixture("vault_object_metadata.json"))
-        result = workos.vault.describe_object(
+        result = workos.vault.get_object_metadata(
             object_id="vault_obj_01EHDAK2BFGWCSZXP9HGZ3VK8C"
         )
         assert isinstance(result, VaultObject)
@@ -246,9 +246,9 @@ async def test_read_object_by_name(self, async_workos, httpx_mock):
         request = httpx_mock.get_request()
         assert request.url.path.endswith("/vault/v1/kv/name/my-secret")
 
-    async def test_describe_object(self, async_workos, httpx_mock):
+    async def test_get_object_metadata(self, async_workos, httpx_mock):
         httpx_mock.add_response(json=load_fixture("vault_object_metadata.json"))
-        result = await async_workos.vault.describe_object(
+        result = await async_workos.vault.get_object_metadata(
             object_id="vault_obj_01EHDAK2BFGWCSZXP9HGZ3VK8C"
         )
         assert isinstance(result, VaultObject)