Added miscellaneous category to documentation

docs/examples.rst

@@ -35,3 +35,10 @@ DynamoDB
 
    examples/dynamo_db/insertions
    examples/dynamo_db/tables
+
+Cognito Identity Provider
+--------
+.. toctree::
+   :maxdepth: 2
+
+   examples/cognito_idp/forgot_password.rst

docs/examples/cognito_idp/forgot_password.rst

@@ -0,0 +1,11 @@
+Cognito Identity Provider
+-------------------
+
+Amazon Cognito Identity Provider (IdP) allows you to manage user authentication and user management for your applications.
+
+We will demonstrate usage with the Cognito forgot password feature.
+
+.. note::
+    This example shows how to use the Cognito forgot password feature.
+
+.. literalinclude:: ../../../examples/cognito_idp_forgot_password.py

examples/cognito_idp_forgot_password.py

@@ -0,0 +1,31 @@
+# Boto should get credentials from ~/.aws/credentials or the environment
+import asyncio
+
+from aiobotocore.session import get_session
+
+
+async def go():
+    session = get_session()
+    async with session.create_client(
+        'cognito-idp',
+        region_name='us-west-2',
+    ) as client:
+        # initiate forgot password
+        resp = await client.forgot_password(
+            ClientId='xxx',
+            Username='xxx',
+        )
+        print(resp)
+
+        # confirm forgot password
+        resp = await client.confirm_forgot_password(
+            ClientId='xxx',
+            Username='xxx',
+            ConfirmationCode='xxx',
+            Password='xxx',
+        )
+        print(resp)
+
+
+if __name__ == '__main__':
+    asyncio.run(go())