diff --git a/docs/src/workflow.md b/docs/src/workflow.md
new file mode 100644
index 00000000..60f258a0
--- /dev/null
+++ b/docs/src/workflow.md
@@ -0,0 +1,3 @@
+![general_workflow](https://github.com/hotosm/raw-data-api/assets/36752999/6dfcb2e2-05ee-4b27-8472-12e3bcd31971)
+![data_structure_](https://github.com/hotosm/raw-data-api/assets/36752999/0c12ef1e-20be-44b1-b472-7d7e8ecbde29)
+![api_workflow](https://github.com/hotosm/raw-data-api/assets/36752999/15aa4ea8-53d4-414c-8c53-ae49d8304da7)