diff --git a/REUSE.toml b/REUSE.toml
index 962b0c0f313..194785a95c1 100644
--- a/REUSE.toml
+++ b/REUSE.toml
@@ -48,7 +48,7 @@ SPDX-FileCopyrightText = "none"
 SPDX-License-Identifier = "CC0-1.0"
 
 [[annotations]]
-path = ["package.json", "package-lock.json", ".git-blame-ignore-revs", "**/package.json", "**/package-lock.json", "composer.json", "composer.patches.json", "composer.lock", "**/composer.json", "**/composer.lock", ".gitignore", ".l10nignore", "psalm.xml", "tests/psalm-baseline.xml", "vendor-bin/**/composer.json", "vendor-bin/**/composer.lock", ".tx/config", "**/phpunit.xml", "tsconfig.json", "redocly.yaml"]
+path = ["package.json", "package-lock.json", ".git-blame-ignore-revs", "**/package.json", "**/package-lock.json", "composer.json", "composer.patches.json", "composer.lock", "**/composer.json", "**/composer.lock", ".gitignore", ".l10nignore", "psalm.xml", "tests/psalm-baseline.xml", "vendor-bin/**/composer.json", "vendor-bin/**/composer.lock", ".tx/config", "**/phpunit.xml", "tsconfig.json"]
 precedence = "aggregate"
 SPDX-FileCopyrightText = "none"
 SPDX-License-Identifier = "CC0-1.0"
diff --git a/redocly.yaml b/redocly.yaml
index 91a23b690a2..f5d54e0cb8c 100644
--- a/redocly.yaml
+++ b/redocly.yaml
@@ -1,3 +1,9 @@
+# SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# Config for Nextcloud Talk API types (ResponseDefinitions -> OpenAPI declaration)
+# apis uses explicit output paths provided per JSON input source
+
 apis:
     openapi@v1:
         root: ./openapi.json
diff --git a/src/types/redocly.yaml b/src/types/redocly.yaml
new file mode 100644
index 00000000000..4f5ce52ef18
--- /dev/null
+++ b/src/types/redocly.yaml
@@ -0,0 +1,7 @@
+# SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+# Minimal config for core Nextcloud types (see generate-core-types.sh).
+# CLI uses explicit input/output paths provided by script instead of redocly.yaml at root.
+rules:
+    struct: off