diff --git a/spec/api.json b/spec/api.json
new file mode 100644
index 0000000..bc3c56f
--- /dev/null
+++ b/spec/api.json
@@ -0,0 +1,28 @@
+{
+  "openapi":"3.0.2",
+  "info": {
+    "title":"API Title",
+    "version":"1.0"
+  },
+  "servers": [
+    {"url":"https://appreports.scode.ovh/v1"}
+  ],
+  "paths": {
+    "/app": {
+      "get": {
+        "description": "list all apps",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "application/json": {
+                
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
\ No newline at end of file