diff --git a/src/utils/openapi-permissions.ts b/src/utils/openapi-permissions.ts index b042fba..f2fb3b3 100644 --- a/src/utils/openapi-permissions.ts +++ b/src/utils/openapi-permissions.ts @@ -109,10 +109,16 @@ export const formatPermissions = (permissions: unknown): string | null => { return null; } + const filtered = filters.length ? `results filtered by ${filters.join(' and ')}` : ''; + + if (!requirements.length && filtered) { + // Filter grants document the operation on their own: no grant is required, results are filtered + return `> ${label} ${filtered}`; + } + const required = requirements.length ? requirements.join(' and ') : 'not documented'; - const filtered = filters.length ? ` · results filtered by ${filters.join(' and ')}` : ''; - return `> ${label} ${required}${filtered}`; + return `> ${label} ${required}${filtered ? ` · ${filtered}` : ''}`; }; /**