diff --git a/docs/.gitignore b/docs/.gitignore
index 0974911..bae05c6 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -1,4 +1,5 @@
 node_modules/
+venv-xos/
 profiles
 test
 xos
diff --git a/docs/Makefile b/docs/Makefile
index ffc598c..5082cb7 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -1,6 +1,8 @@
+SHELL := /bin/bash
+
 default: book
 
-build:
+build: swagger
 	ln -s ../platform-install/docs platform-install && \
 	ln -s ../../test/cord-tester/docs test && \
 	ln -s ../../orchestration/xos/docs xos && \
@@ -24,3 +26,7 @@
 	rm -f ../../orchestration/xos-gui/docs/docs; \
 	rm -f ../../orchestration/profiles/profiles
 
+swagger:
+	pushd ../../orchestration/xos/; source scripts/setup_venv.sh; popd;
+	pushd ../../orchestration/xos/docs/; make swagger_docs; popd;
+