Ondemand report input schema format

docs/guides/ondemand-reports.md

@@ -0,0 +1,29 @@
+---
+title: On-demand Reports
+sidebar_label: On-demand Reports (Beta)
+description:
+  CodeRabbit offers a way to generate on-demand reports using a simple API request
+sidebar_position: 5
+---
+
+```mdx-code-block
+import ReportSchema from "@site/src/components/ReportSchema";
+```
+
+:::info
+
+This feature is in beta
+
+:::
+
+CodeRabbit offers a way to generate on-demand reports using the [API](https://api.coderabbit.ai/api/swagger/).
+You will be able to use the API by creating an [API key](https://app.coderabbit.ai/settings/api-keys).
+
+
+On-demand report input schema:
+
+```mdx-code-block
+<ReportSchema />
+```
+
+[API Reference](https://api.coderabbit.ai/api/swagger/)

src/components/ReportSchema.tsx

@@ -0,0 +1,6 @@
+import Schema from "@site/static/schema/reporting.json";
+import JSONSchemaViewer from "@theme/JSONSchemaViewer";
+
+export default function Viewer(): JSX.Element {
+  return <JSONSchemaViewer schema={Schema} />;
+}

static/schema/reporting.json

@@ -0,0 +1,93 @@
+{
+	"type": "object",
+	"properties": {
+		"scheduleRange": {
+			"type": "string",
+			"enum": [
+				"Dates"
+			]
+		},
+		"from": {
+			"type": "string",
+			"format": "date"
+		},
+		"to": {
+			"type": "string",
+			"format": "date"
+		},
+		"prompt": {
+			"type": "string"
+		},
+		"promptTemplate": {
+			"type": "string",
+			"enum": [
+				"Daily Standup Report",
+				"Sprint Report",
+				"Release Notes",
+				"Custom"
+			]
+		},
+		"parameters": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"parameter": {
+						"type": "string",
+						"enum": [
+							"REPOSITORY",
+							"LABEL",
+							"TEAM",
+							"USER"
+						]
+					},
+					"operator": {
+						"type": "string",
+						"enum": [
+							"IN",
+							"ALL"
+						]
+					},
+					"values": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						}
+					}
+				},
+				"required": [
+					"parameter",
+					"operator",
+					"values"
+				],
+				"additionalProperties": false
+			}
+		},
+		"groupBy": {
+			"type": "string",
+			"enum": [
+				"NONE",
+				"REPOSITORY",
+				"LABEL",
+				"TEAM",
+				"USER"
+			]
+		},
+		"subgroupBy": {
+			"type": "string",
+			"enum": [
+				"NONE",
+				"REPOSITORY",
+				"LABEL",
+				"TEAM",
+				"USER"
+			]
+		}
+	},
+	"required": [
+		"from",
+		"to"
+	],
+	"additionalProperties": false,
+	"$schema": "http://json-schema.org/draft-07/schema#"
+}