diff --git a/docs/build/.gitignore b/docs/build/.gitignore
deleted file mode 100644
index d1f1fb7dc96..00000000000
--- a/docs/build/.gitignore
+++ /dev/null
@@ -1,3 +0,0 @@
-apis/*
-!apis/welcome.md
-!apis/sidebars.ts
\ No newline at end of file
diff --git a/docs/build/apis/.gitignore b/docs/build/apis/.gitignore
new file mode 100644
index 00000000000..aa5e17ea485
--- /dev/null
+++ b/docs/build/apis/.gitignore
@@ -0,0 +1,2 @@
+docs/*
+!docs/welcome.md
\ No newline at end of file
diff --git a/docs/build/apis/welcome.md b/docs/build/apis/docs/welcome.md
similarity index 100%
rename from docs/build/apis/welcome.md
rename to docs/build/apis/docs/welcome.md
diff --git a/docs/build/apis/sidebars.ts b/docs/build/apis/sidebars.js
similarity index 75%
rename from docs/build/apis/sidebars.ts
rename to docs/build/apis/sidebars.js
index 08306218d3c..651dc4af93a 100644
--- a/docs/build/apis/sidebars.ts
+++ b/docs/build/apis/sidebars.js
@@ -17,13 +17,13 @@ module.exports = {
           type: 'category',
           label: 'V1',
           collapsed: true,
-          items: require('./core/v1/sidebar'),
+          items: require('./docs/core/v1/sidebar'),
         },
         {
           type: 'category',
           label: 'V2',
           collapsed: true,
-          items: require('./core/v2/sidebar'),
+          items: require('./docs/core/v2/sidebar'),
         },
       ],
     },
@@ -31,31 +31,31 @@ module.exports = {
       type: 'category',
       label: 'Wasp',
       collapsed: true,
-      items: require('./wasp/sidebar'),
+      items: require('./docs/wasp/sidebar'),
     },
     {
       type: 'category',
       label: 'Explorer',
       collapsed: true,
-      items: require('./explorer/sidebar'),
+      items: require('./docs/explorer/sidebar'),
     },
     {
       type: 'category',
       label: 'Indexer',
       collapsed: true,
-      items: require('./indexer/sidebar'),
+      items: require('./docs/indexer/sidebar'),
     },
     {
       type: 'category',
       label: 'IRC Metadata',
       collapsed: true,
-      items: require('./irc-metadata/sidebar'),
+      items: require('./docs/irc-metadata/sidebar'),
     },
     {
       type: 'category',
       label: 'PoI',
       collapsed: true,
-      items: require('./poi/sidebar'),
+      items: require('./docs/poi/sidebar'),
     },
   ],
 };
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 19ec4998b65..e145fca4fec 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -173,7 +173,7 @@ module.exports = async () => {
               coreApiChrysalis: {
                 specPath:
                   'https://raw.githubusercontent.com/iotaledger/tips/main/tips/TIP-0013/rest-api.yaml',
-                outputDir: path.resolve(__dirname, 'docs/build/apis/core/v1'),
+                outputDir: path.resolve(__dirname, 'docs/build/apis/docs/core/v1'),
                 sidebarOptions: {
                   groupPathsBy: 'tag',
                 },
@@ -181,7 +181,7 @@ module.exports = async () => {
               coreApiShimmer: {
                 specPath:
                   'https://raw.githubusercontent.com/iotaledger/tips/main/tips/TIP-0025/core-rest-api.yaml',
-                outputDir: path.resolve(__dirname, 'docs/build/apis/core/v2'),
+                outputDir: path.resolve(__dirname, 'docs/build/apis/docs/core/v2'),
                 sidebarOptions: {
                   groupPathsBy: 'tag',
                 },
@@ -189,7 +189,7 @@ module.exports = async () => {
               waspApi: {
                 specPath:
                   'https://raw.githubusercontent.com/iotaledger/wasp/develop/clients/apiclient/api/openapi.yaml',
-                outputDir: path.resolve(__dirname, 'docs/build/apis/wasp'),
+                outputDir: path.resolve(__dirname, 'docs/build/apis/docs/wasp'),
                 sidebarOptions: {
                   groupPathsBy: 'tag',
                 },
@@ -197,7 +197,7 @@ module.exports = async () => {
               indexerApi: {
                 specPath:
                   'https://raw.githubusercontent.com/iotaledger/tips/main/tips/TIP-0026/indexer-rest-api.yaml',
-                outputDir: path.resolve(__dirname, 'docs/build/apis/indexer'),
+                outputDir: path.resolve(__dirname, 'docs/build/apis/docs/indexer'),
                 sidebarOptions: {
                   groupPathsBy: 'tag',
                 },
@@ -205,7 +205,7 @@ module.exports = async () => {
               poiApi: {
                 specPath:
                   'https://raw.githubusercontent.com/iotaledger/inx-poi/develop/rest-api.yaml',
-                outputDir: path.resolve(__dirname, 'docs/build/apis/poi'),
+                outputDir: path.resolve(__dirname, 'docs/build/apis/docs/poi'),
                 sidebarOptions: {
                   groupPathsBy: 'tag',
                 },
@@ -213,7 +213,7 @@ module.exports = async () => {
               explorerApi: {
                 specPath:
                   'https://raw.githubusercontent.com/iotaledger/inx-chronicle/main/documentation/api/api-explorer.yml',
-                outputDir: path.resolve(__dirname, 'docs/build/apis/explorer'),
+                outputDir: path.resolve(__dirname, 'docs/build/apis/docs/explorer'),
                 sidebarOptions: {
                   groupPathsBy: 'tag',
                 },
@@ -223,7 +223,7 @@ module.exports = async () => {
                   'https://raw.githubusercontent.com/iotaledger/inx-irc-metadata/develop/rest-api.yaml',
                 outputDir: path.resolve(
                   __dirname,
-                  'docs/build/apis/irc-metadata',
+                  'docs/build/apis/docs/irc-metadata',
                 ),
                 sidebarOptions: {
                   groupPathsBy: 'tag',