docs: deprecate old access token getter (#315)

api.md

@@ -8,7 +8,6 @@ from finch.types import ConnectionStatusType, OperationSupport, OperationSupport
 
 Methods:
 
-- <code>client.<a href="./src/finch/_client.py">get_access_token</a>(\*args) -> str</code>
 - <code>client.<a href="./src/finch/_client.py">get_auth_url</a>(\*args) -> str</code>
 - <code>client.<a href="./src/finch/_client.py">with_access_token</a>(\*args) -> Self</code>
 

src/finch/_client.py

@@ -307,11 +307,7 @@ def get_access_token(
         *,
         redirect_uri: str | None = None,
     ) -> str:
-        """Returns an access token for the Finch API given an authorization code.
-
-        An authorization code can be obtained by visiting the url returned by
-        get_auth_url().
-        """
+        """DEPRECATED: use client.access_tokens.create instead."""
         if self.client_id is None:
             raise ValueError("Expected client_id to be set in order to call get_access_token")
 
@@ -659,11 +655,7 @@ async def get_access_token(
         *,
         redirect_uri: str | None = None,
     ) -> str:
-        """Returns an access token for the Finch API given an authorization code.
-
-        An authorization code can be obtained by visiting the url returned by
-        get_auth_url().
-        """
+        """DEPRECATED: use client.access_tokens.create instead."""
         if self.client_id is None:
             raise ValueError("Expected client_id to be set in order to call get_access_token")