diff --git a/modules/util/assume_role/README.md b/modules/util/assume_role/README.md
new file mode 100644
index 0000000..1eb81ee
--- /dev/null
+++ b/modules/util/assume_role/README.md
@@ -0,0 +1,18 @@
+# assume_role module
+This module calls sts and run assume role. Returns the temp credential as a map.
+
+## System requirements
+* awscli
+* jq
+
+## Outputs
+temp_credential: A map of strings returned by awscli. Variable is sensitive.
+
+```json
+{
+    "AccessKeyId": "111",
+    "SecretAccessKey": "222",
+    "SessionToken": "333",
+    "Expiration": "2023-07-01T10:19:47+00:00"
+}
+```
\ No newline at end of file