Update

Annybell Villarroel · Annybell Villarroel · commit dbfe8c17c336 · 2017-02-15T11:57:07.000+01:00
diff --git a/auth0/v2/authentication/get_token.py b/auth0/v2/authentication/get_token.py
@@ -3,7 +3,7 @@
 
 class GetToken(AuthenticationBase):
 
-    """oauth/token related endpoints
+    """Oauth/token related endpoints
 
     Args:
         domain (str): Your auth0 domain (e.g: username.auth0.com)
@@ -19,6 +19,22 @@ def authorization_code(self, client_id, client_secret, code,
         This is the OAuth 2.0 grant that regular web apps utilize in order 
         to access an API. Use this endpoint to exchange an Authorization Code 
         for a Token.
+
+        Args:
+            grant_type (str): Denotes the flow you're using. For authorization code
+            use authorization_code
+
+            client_id (str): your application's client Id
+
+            client_secret (str): you application's client Secret
+            
+            code (str): The Authorization Code received from the /authorize Calls
+
+            redirect_uri (srt, optional): This is required only if it was set at 
+            the GET /authorize endpoint. The values must match
+
+        Returns:
+            access_token, id_token
         """
 
         return self.post(
@@ -41,6 +57,19 @@ def client_credentials(self, client_id, client_secret, audience,
         order to access an API. Use this endpoint to directly request 
         an access_token by using the Client Credentials (a Client Id and 
         a Client Secret).
+
+        Args:
+            grant_type (str): Denotes the flow you're using. For client credentials
+            use client_credentials
+
+            client_id (str): your application's client Id
+
+            client_secret (str): you application's client Secret
+            
+            audience (str): The unique identifier of the target API you want to access.
+
+        Returns:
+            access_token
         """
 
         return self.post(
@@ -65,6 +94,30 @@ def login(self, client_id, client_secret, username, password, scope, realm
         (browser). This information is later on sent to the client and Auth0. 
         It is therefore imperative that the client is absolutely trusted with 
         this information.
+
+        Args:
+            grant_type (str): Denotes the flow you're using. For password realm
+            use http://auth0.com/oauth/grant-type/password-realm
+
+            client_id (str): your application's client Id
+
+            client_secret (str): you application's client Secret
+            
+            audience (str): The unique identifier of the target API you want to access.
+
+            username (str): Resource owner's identifier
+
+            password (str): resource owner's Secret
+            
+            scope(srt): String value of the different scopes the client is asking for. 
+            Multiple scopes are separated with whitespace.
+
+            realm (str): String value of the realm the user belongs. 
+            Set this if you want to add realm support at this grant.
+
+
+        Returns:
+            access_token, id_token
         """
 
         return self.post(
diff --git a/auth0/v2/authentication/users.py b/auth0/v2/authentication/users.py
@@ -15,6 +15,7 @@ def __init__(self, domain):
     def userinfo(self, access_token):
 
         """Returns the user information based on the Auth0 access token.
+        This endpoint will work only if openid was granted as a scope for the access_token.
 
         Args:
             access_token (str): Auth0 access token (obtained during login).
