diff --git a/Makefile b/Makefile
index 4d23186..8eb45ff 100644
--- a/Makefile
+++ b/Makefile
@@ -51,6 +51,7 @@ dist: pip
 
 # Target to generate HTML documentation
 docs: pip-dev
+	mkdir -p docs/develop
 	cp README.md docs/develop/getting_started.md
 	# remove top level header and coresponding description
 	sed -i '/^##[^#]/,$$!d' docs/develop/getting_started.md
diff --git a/docs/akkudoktoreos/serverapi.rst b/docs/akkudoktoreos/serverapi.rst
index c93e3a2..5851644 100644
--- a/docs/akkudoktoreos/serverapi.rst
+++ b/docs/akkudoktoreos/serverapi.rst
@@ -7,7 +7,7 @@
 Server API
 ##########
 
-For a more detailed documentation see the Swagger interface: `EOS OpenAPI Spec <https://petstore3.swagger.io/?url=https://raw.githubusercontent.com/Akkudoktor-EOS/EOS/refs/heads/main/openapi.json>`_
+For a more detailed documentation see the Swagger interface: `EOS OpenAPI Spec <https://petstore3.swagger.io/?url=https://raw.githubusercontent.com/Akkudoktor-EOS/EOS/refs/heads/main/docs/akkudoktoreos/openapi.json>`_
 
 .. openapi:: openapi.json
    :examples: