telnyx 3.1.0__py3-none-any.whl → 3.2.0__py3-none-any.whl

telnyx/resources/oauth.py

@@ -8,11 +8,11 @@ from typing_extensions import Literal
 import httpx
 
 from ..types import (
-    oauth_authorize_params,
-    oauth_create_grant_params,
-    oauth_exchange_token_params,
-    oauth_register_client_params,
-    oauth_introspect_token_params,
+    oauth_token_params,
+    oauth_grants_params,
+    oauth_register_params,
+    oauth_introspect_params,
+    oauth_retrieve_authorize_params,
 )
 from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
@@ -25,12 +25,12 @@ from .._response import (
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
-from ..types.oauth_create_grant_response import OAuthCreateGrantResponse
+from ..types.oauth_token_response import OAuthTokenResponse
+from ..types.oauth_grants_response import OAuthGrantsResponse
+from ..types.oauth_register_response import OAuthRegisterResponse
+from ..types.oauth_retrieve_response import OAuthRetrieveResponse
+from ..types.oauth_introspect_response import OAuthIntrospectResponse
 from ..types.oauth_retrieve_jwks_response import OAuthRetrieveJwksResponse
-from ..types.oauth_exchange_token_response import OAuthExchangeTokenResponse
-from ..types.oauth_register_client_response import OAuthRegisterClientResponse
-from ..types.oauth_introspect_token_response import OAuthIntrospectTokenResponse
-from ..types.oauth_retrieve_consent_response import OAuthRetrieveConsentResponse
 
 __all__ = ["OAuthResource", "AsyncOAuthResource"]
 
@@ -55,41 +55,21 @@ class OAuthResource(SyncAPIResource):
         """
         return OAuthResourceWithStreamingResponse(self)
 
-    def authorize(
+    def retrieve(
         self,
+        consent_token: str,
         *,
-        client_id: str,
-        redirect_uri: str,
-        response_type: Literal["code"],
-        code_challenge: str | Omit = omit,
-        code_challenge_method: Literal["plain", "S256"] | Omit = omit,
-        scope: str | Omit = omit,
-        state: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> None:
+    ) -> OAuthRetrieveResponse:
         """
-        OAuth 2.0 authorization endpoint for the authorization code flow
+        Retrieve details about an OAuth consent token
 
         Args:
-          client_id: OAuth client identifier
-
-          redirect_uri: Redirect URI
-
-          response_type: OAuth response type
-
-          code_challenge: PKCE code challenge
-
-          code_challenge_method: PKCE code challenge method
-
-          scope: Space-separated list of requested scopes
-
-          state: State parameter for CSRF protection
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -98,31 +78,17 @@ class OAuthResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        if not consent_token:
+            raise ValueError(f"Expected a non-empty value for `consent_token` but received {consent_token!r}")
         return self._get(
-            "/oauth/authorize",
+            f"/oauth/consent/{consent_token}",
             options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform(
-                    {
-                        "client_id": client_id,
-                        "redirect_uri": redirect_uri,
-                        "response_type": response_type,
-                        "code_challenge": code_challenge,
-                        "code_challenge_method": code_challenge_method,
-                        "scope": scope,
-                        "state": state,
-                    },
-                    oauth_authorize_params.OAuthAuthorizeParams,
-                ),
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=OAuthRetrieveResponse,
         )
 
-    def create_grant(
+    def grants(
         self,
         *,
         allowed: bool,
@@ -133,7 +99,7 @@ class OAuthResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthCreateGrantResponse:
+    ) -> OAuthGrantsResponse:
         """
         Create an OAuth authorization grant
 
@@ -157,83 +123,15 @@ class OAuthResource(SyncAPIResource):
                     "allowed": allowed,
                     "consent_token": consent_token,
                 },
-                oauth_create_grant_params.OAuthCreateGrantParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=OAuthCreateGrantResponse,
-        )
-
-    def exchange_token(
-        self,
-        *,
-        grant_type: Literal["client_credentials", "authorization_code", "refresh_token"],
-        client_id: str | Omit = omit,
-        client_secret: str | Omit = omit,
-        code: str | Omit = omit,
-        code_verifier: str | Omit = omit,
-        redirect_uri: str | Omit = omit,
-        refresh_token: str | Omit = omit,
-        scope: str | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthExchangeTokenResponse:
-        """
-        Exchange authorization code, client credentials, or refresh token for access
-        token
-
-        Args:
-          grant_type: OAuth 2.0 grant type
-
-          client_id: OAuth client ID (if not using HTTP Basic auth)
-
-          client_secret: OAuth client secret (if not using HTTP Basic auth)
-
-          code: Authorization code (for authorization_code flow)
-
-          code_verifier: PKCE code verifier (for authorization_code flow)
-
-          redirect_uri: Redirect URI (for authorization_code flow)
-
-          refresh_token: Refresh token (for refresh_token flow)
-
-          scope: Space-separated list of requested scopes (for client_credentials)
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        return self._post(
-            "/oauth/token",
-            body=maybe_transform(
-                {
-                    "grant_type": grant_type,
-                    "client_id": client_id,
-                    "client_secret": client_secret,
-                    "code": code,
-                    "code_verifier": code_verifier,
-                    "redirect_uri": redirect_uri,
-                    "refresh_token": refresh_token,
-                    "scope": scope,
-                },
-                oauth_exchange_token_params.OAuthExchangeTokenParams,
+                oauth_grants_params.OAuthGrantsParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthExchangeTokenResponse,
+            cast_to=OAuthGrantsResponse,
         )
 
-    def introspect_token(
+    def introspect(
         self,
         *,
         token: str,
@@ -243,7 +141,7 @@ class OAuthResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthIntrospectTokenResponse:
+    ) -> OAuthIntrospectResponse:
         """
         Introspect an OAuth access token to check its validity and metadata
 
@@ -260,14 +158,14 @@ class OAuthResource(SyncAPIResource):
         """
         return self._post(
             "/oauth/introspect",
-            body=maybe_transform({"token": token}, oauth_introspect_token_params.OAuthIntrospectTokenParams),
+            body=maybe_transform({"token": token}, oauth_introspect_params.OAuthIntrospectParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthIntrospectTokenResponse,
+            cast_to=OAuthIntrospectResponse,
         )
 
-    def register_client(
+    def register(
         self,
         *,
         client_name: str | Omit = omit,
@@ -285,7 +183,7 @@ class OAuthResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthRegisterClientResponse:
+    ) -> OAuthRegisterResponse:
         """
         Register a new OAuth client dynamically (RFC 7591)
 
@@ -330,88 +228,15 @@ class OAuthResource(SyncAPIResource):
                     "token_endpoint_auth_method": token_endpoint_auth_method,
                     "tos_uri": tos_uri,
                 },
-                oauth_register_client_params.OAuthRegisterClientParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=OAuthRegisterClientResponse,
-        )
-
-    def retrieve_consent(
-        self,
-        consent_token: str,
-        *,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthRetrieveConsentResponse:
-        """
-        Retrieve details about an OAuth consent token
-
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not consent_token:
-            raise ValueError(f"Expected a non-empty value for `consent_token` but received {consent_token!r}")
-        return self._get(
-            f"/oauth/consent/{consent_token}",
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                oauth_register_params.OAuthRegisterParams,
             ),
-            cast_to=OAuthRetrieveConsentResponse,
-        )
-
-    def retrieve_jwks(
-        self,
-        *,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthRetrieveJwksResponse:
-        """Retrieve the JSON Web Key Set for token verification"""
-        return self._get(
-            "/oauth/jwks",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthRetrieveJwksResponse,
+            cast_to=OAuthRegisterResponse,
         )
 
-
-class AsyncOAuthResource(AsyncAPIResource):
-    @cached_property
-    def with_raw_response(self) -> AsyncOAuthResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/team-telnyx/telnyx-python#accessing-raw-response-data-eg-headers
-        """
-        return AsyncOAuthResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> AsyncOAuthResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/team-telnyx/telnyx-python#with_streaming_response
-        """
-        return AsyncOAuthResourceWithStreamingResponse(self)
-
-    async def authorize(
+    def retrieve_authorize(
         self,
         *,
         client_id: str,
@@ -455,14 +280,14 @@ class AsyncOAuthResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
-        return await self._get(
+        return self._get(
             "/oauth/authorize",
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform(
+                query=maybe_transform(
                     {
                         "client_id": client_id,
                         "redirect_uri": redirect_uri,
@@ -472,56 +297,32 @@ class AsyncOAuthResource(AsyncAPIResource):
                         "scope": scope,
                         "state": state,
                     },
-                    oauth_authorize_params.OAuthAuthorizeParams,
+                    oauth_retrieve_authorize_params.OAuthRetrieveAuthorizeParams,
                 ),
             ),
             cast_to=NoneType,
         )
 
-    async def create_grant(
+    def retrieve_jwks(
         self,
         *,
-        allowed: bool,
-        consent_token: str,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthCreateGrantResponse:
-        """
-        Create an OAuth authorization grant
-
-        Args:
-          allowed: Whether the grant is allowed
-
-          consent_token: Consent token
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        return await self._post(
-            "/oauth/grants",
-            body=await async_maybe_transform(
-                {
-                    "allowed": allowed,
-                    "consent_token": consent_token,
-                },
-                oauth_create_grant_params.OAuthCreateGrantParams,
-            ),
+    ) -> OAuthRetrieveJwksResponse:
+        """Retrieve the JSON Web Key Set for token verification"""
+        return self._get(
+            "/oauth/jwks",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthCreateGrantResponse,
+            cast_to=OAuthRetrieveJwksResponse,
         )
 
-    async def exchange_token(
+    def token(
         self,
         *,
         grant_type: Literal["client_credentials", "authorization_code", "refresh_token"],
@@ -538,7 +339,7 @@ class AsyncOAuthResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthExchangeTokenResponse:
+    ) -> OAuthTokenResponse:
         """
         Exchange authorization code, client credentials, or refresh token for access
         token
@@ -568,9 +369,9 @@ class AsyncOAuthResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return await self._post(
+        return self._post(
             "/oauth/token",
-            body=await async_maybe_transform(
+            body=maybe_transform(
                 {
                     "grant_type": grant_type,
                     "client_id": client_id,
@@ -581,15 +382,112 @@ class AsyncOAuthResource(AsyncAPIResource):
                     "refresh_token": refresh_token,
                     "scope": scope,
                 },
-                oauth_exchange_token_params.OAuthExchangeTokenParams,
+                oauth_token_params.OAuthTokenParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=OAuthTokenResponse,
+        )
+
+
+class AsyncOAuthResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncOAuthResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/team-telnyx/telnyx-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncOAuthResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncOAuthResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/team-telnyx/telnyx-python#with_streaming_response
+        """
+        return AsyncOAuthResourceWithStreamingResponse(self)
+
+    async def retrieve(
+        self,
+        consent_token: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> OAuthRetrieveResponse:
+        """
+        Retrieve details about an OAuth consent token
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not consent_token:
+            raise ValueError(f"Expected a non-empty value for `consent_token` but received {consent_token!r}")
+        return await self._get(
+            f"/oauth/consent/{consent_token}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=OAuthRetrieveResponse,
+        )
+
+    async def grants(
+        self,
+        *,
+        allowed: bool,
+        consent_token: str,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> OAuthGrantsResponse:
+        """
+        Create an OAuth authorization grant
+
+        Args:
+          allowed: Whether the grant is allowed
+
+          consent_token: Consent token
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/oauth/grants",
+            body=await async_maybe_transform(
+                {
+                    "allowed": allowed,
+                    "consent_token": consent_token,
+                },
+                oauth_grants_params.OAuthGrantsParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthExchangeTokenResponse,
+            cast_to=OAuthGrantsResponse,
         )
 
-    async def introspect_token(
+    async def introspect(
         self,
         *,
         token: str,
@@ -599,7 +497,7 @@ class AsyncOAuthResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthIntrospectTokenResponse:
+    ) -> OAuthIntrospectResponse:
         """
         Introspect an OAuth access token to check its validity and metadata
 
@@ -616,16 +514,14 @@ class AsyncOAuthResource(AsyncAPIResource):
         """
         return await self._post(
             "/oauth/introspect",
-            body=await async_maybe_transform(
-                {"token": token}, oauth_introspect_token_params.OAuthIntrospectTokenParams
-            ),
+            body=await async_maybe_transform({"token": token}, oauth_introspect_params.OAuthIntrospectParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthIntrospectTokenResponse,
+            cast_to=OAuthIntrospectResponse,
         )
 
-    async def register_client(
+    async def register(
         self,
         *,
         client_name: str | Omit = omit,
@@ -643,7 +539,7 @@ class AsyncOAuthResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthRegisterClientResponse:
+    ) -> OAuthRegisterResponse:
         """
         Register a new OAuth client dynamically (RFC 7591)
 
@@ -688,29 +584,49 @@ class AsyncOAuthResource(AsyncAPIResource):
                     "token_endpoint_auth_method": token_endpoint_auth_method,
                     "tos_uri": tos_uri,
                 },
-                oauth_register_client_params.OAuthRegisterClientParams,
+                oauth_register_params.OAuthRegisterParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=OAuthRegisterClientResponse,
+            cast_to=OAuthRegisterResponse,
         )
 
-    async def retrieve_consent(
+    async def retrieve_authorize(
         self,
-        consent_token: str,
         *,
+        client_id: str,
+        redirect_uri: str,
+        response_type: Literal["code"],
+        code_challenge: str | Omit = omit,
+        code_challenge_method: Literal["plain", "S256"] | Omit = omit,
+        scope: str | Omit = omit,
+        state: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> OAuthRetrieveConsentResponse:
+    ) -> None:
         """
-        Retrieve details about an OAuth consent token
+        OAuth 2.0 authorization endpoint for the authorization code flow
 
         Args:
+          client_id: OAuth client identifier
+
+          redirect_uri: Redirect URI
+
+          response_type: OAuth response type
+
+          code_challenge: PKCE code challenge
+
+          code_challenge_method: PKCE code challenge method
+
+          scope: Space-separated list of requested scopes
+
+          state: State parameter for CSRF protection
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -719,14 +635,28 @@ class AsyncOAuthResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not consent_token:
-            raise ValueError(f"Expected a non-empty value for `consent_token` but received {consent_token!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._get(
-            f"/oauth/consent/{consent_token}",
+            "/oauth/authorize",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "client_id": client_id,
+                        "redirect_uri": redirect_uri,
+                        "response_type": response_type,
+                        "code_challenge": code_challenge,
+                        "code_challenge_method": code_challenge_method,
+                        "scope": scope,
+                        "state": state,
+                    },
+                    oauth_retrieve_authorize_params.OAuthRetrieveAuthorizeParams,
+                ),
             ),
-            cast_to=OAuthRetrieveConsentResponse,
+            cast_to=NoneType,
         )
 
     async def retrieve_jwks(
@@ -748,110 +678,178 @@ class AsyncOAuthResource(AsyncAPIResource):
             cast_to=OAuthRetrieveJwksResponse,
         )
 
+    async def token(
+        self,
+        *,
+        grant_type: Literal["client_credentials", "authorization_code", "refresh_token"],
+        client_id: str | Omit = omit,
+        client_secret: str | Omit = omit,
+        code: str | Omit = omit,
+        code_verifier: str | Omit = omit,
+        redirect_uri: str | Omit = omit,
+        refresh_token: str | Omit = omit,
+        scope: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> OAuthTokenResponse:
+        """
+        Exchange authorization code, client credentials, or refresh token for access
+        token
+
+        Args:
+          grant_type: OAuth 2.0 grant type
+
+          client_id: OAuth client ID (if not using HTTP Basic auth)
+
+          client_secret: OAuth client secret (if not using HTTP Basic auth)
+
+          code: Authorization code (for authorization_code flow)
+
+          code_verifier: PKCE code verifier (for authorization_code flow)
+
+          redirect_uri: Redirect URI (for authorization_code flow)
+
+          refresh_token: Refresh token (for refresh_token flow)
+
+          scope: Space-separated list of requested scopes (for client_credentials)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/oauth/token",
+            body=await async_maybe_transform(
+                {
+                    "grant_type": grant_type,
+                    "client_id": client_id,
+                    "client_secret": client_secret,
+                    "code": code,
+                    "code_verifier": code_verifier,
+                    "redirect_uri": redirect_uri,
+                    "refresh_token": refresh_token,
+                    "scope": scope,
+                },
+                oauth_token_params.OAuthTokenParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=OAuthTokenResponse,
+        )
+
 
 class OAuthResourceWithRawResponse:
     def __init__(self, oauth: OAuthResource) -> None:
         self._oauth = oauth
 
-        self.authorize = to_raw_response_wrapper(
-            oauth.authorize,
-        )
-        self.create_grant = to_raw_response_wrapper(
-            oauth.create_grant,
+        self.retrieve = to_raw_response_wrapper(
+            oauth.retrieve,
         )
-        self.exchange_token = to_raw_response_wrapper(
-            oauth.exchange_token,
+        self.grants = to_raw_response_wrapper(
+            oauth.grants,
         )
-        self.introspect_token = to_raw_response_wrapper(
-            oauth.introspect_token,
+        self.introspect = to_raw_response_wrapper(
+            oauth.introspect,
         )
-        self.register_client = to_raw_response_wrapper(
-            oauth.register_client,
+        self.register = to_raw_response_wrapper(
+            oauth.register,
         )
-        self.retrieve_consent = to_raw_response_wrapper(
-            oauth.retrieve_consent,
+        self.retrieve_authorize = to_raw_response_wrapper(
+            oauth.retrieve_authorize,
         )
         self.retrieve_jwks = to_raw_response_wrapper(
             oauth.retrieve_jwks,
         )
+        self.token = to_raw_response_wrapper(
+            oauth.token,
+        )
 
 
 class AsyncOAuthResourceWithRawResponse:
     def __init__(self, oauth: AsyncOAuthResource) -> None:
         self._oauth = oauth
 
-        self.authorize = async_to_raw_response_wrapper(
-            oauth.authorize,
+        self.retrieve = async_to_raw_response_wrapper(
+            oauth.retrieve,
         )
-        self.create_grant = async_to_raw_response_wrapper(
-            oauth.create_grant,
+        self.grants = async_to_raw_response_wrapper(
+            oauth.grants,
         )
-        self.exchange_token = async_to_raw_response_wrapper(
-            oauth.exchange_token,
+        self.introspect = async_to_raw_response_wrapper(
+            oauth.introspect,
         )
-        self.introspect_token = async_to_raw_response_wrapper(
-            oauth.introspect_token,
+        self.register = async_to_raw_response_wrapper(
+            oauth.register,
         )
-        self.register_client = async_to_raw_response_wrapper(
-            oauth.register_client,
-        )
-        self.retrieve_consent = async_to_raw_response_wrapper(
-            oauth.retrieve_consent,
+        self.retrieve_authorize = async_to_raw_response_wrapper(
+            oauth.retrieve_authorize,
         )
         self.retrieve_jwks = async_to_raw_response_wrapper(
             oauth.retrieve_jwks,
         )
+        self.token = async_to_raw_response_wrapper(
+            oauth.token,
+        )
 
 
 class OAuthResourceWithStreamingResponse:
     def __init__(self, oauth: OAuthResource) -> None:
         self._oauth = oauth
 
-        self.authorize = to_streamed_response_wrapper(
-            oauth.authorize,
-        )
-        self.create_grant = to_streamed_response_wrapper(
-            oauth.create_grant,
+        self.retrieve = to_streamed_response_wrapper(
+            oauth.retrieve,
         )
-        self.exchange_token = to_streamed_response_wrapper(
-            oauth.exchange_token,
+        self.grants = to_streamed_response_wrapper(
+            oauth.grants,
         )
-        self.introspect_token = to_streamed_response_wrapper(
-            oauth.introspect_token,
+        self.introspect = to_streamed_response_wrapper(
+            oauth.introspect,
         )
-        self.register_client = to_streamed_response_wrapper(
-            oauth.register_client,
+        self.register = to_streamed_response_wrapper(
+            oauth.register,
         )
-        self.retrieve_consent = to_streamed_response_wrapper(
-            oauth.retrieve_consent,
+        self.retrieve_authorize = to_streamed_response_wrapper(
+            oauth.retrieve_authorize,
         )
         self.retrieve_jwks = to_streamed_response_wrapper(
             oauth.retrieve_jwks,
         )
+        self.token = to_streamed_response_wrapper(
+            oauth.token,
+        )
 
 
 class AsyncOAuthResourceWithStreamingResponse:
     def __init__(self, oauth: AsyncOAuthResource) -> None:
         self._oauth = oauth
 
-        self.authorize = async_to_streamed_response_wrapper(
-            oauth.authorize,
-        )
-        self.create_grant = async_to_streamed_response_wrapper(
-            oauth.create_grant,
+        self.retrieve = async_to_streamed_response_wrapper(
+            oauth.retrieve,
         )
-        self.exchange_token = async_to_streamed_response_wrapper(
-            oauth.exchange_token,
+        self.grants = async_to_streamed_response_wrapper(
+            oauth.grants,
         )
-        self.introspect_token = async_to_streamed_response_wrapper(
-            oauth.introspect_token,
+        self.introspect = async_to_streamed_response_wrapper(
+            oauth.introspect,
         )
-        self.register_client = async_to_streamed_response_wrapper(
-            oauth.register_client,
+        self.register = async_to_streamed_response_wrapper(
+            oauth.register,
         )
-        self.retrieve_consent = async_to_streamed_response_wrapper(
-            oauth.retrieve_consent,
+        self.retrieve_authorize = async_to_streamed_response_wrapper(
+            oauth.retrieve_authorize,
         )
         self.retrieve_jwks = async_to_streamed_response_wrapper(
             oauth.retrieve_jwks,
         )
+        self.token = async_to_streamed_response_wrapper(
+            oauth.token,
+        )