Autogenerated HTML from Bruno collection doesn't support "auth: inherit" for requests

[the-halfbloodprince]

JIRA

I have checked the following:

• I have searched existing issues and found nothing related to my issue.

This bug is:

• making Bruno unusable for me
• slowing me down but I'm able to continue working
• annoying
• this feature was working in a previous version but is broken in the current release.

Bruno version

3.3.0

Operating System

macOS

Describe the bug

Describe the bug

When using collections in the OpenCollection format, requests with auth: inherit are not handled correctly in the generated HTML docs. The auth type dropdown does not include an "Inherit" option, and the effective auth type is not resolved from the parent folder or collection either — the request just shows "No Auth".

After investigating, I also found that inherit is defined in the OpenCollection schema, but only as a string constant (Option 9 under the auth oneOf — a string type with a constant value of "inherit"), rather than as a dedicated named auth type like AuthBearer or AuthBasic. See: https://schema.opencollection.com

This means inherit is technically valid per the spec, but maybe because it carries no structure of its own, the HTML doc generator probably doesn't resolve what it actually means at runtime (just my assumption, please correct me wherever I am wrong) — it can't look up the inheritance chain to determine the effective auth type from the parent folder or collection.

Expected behavior

The generated HTML docs should either:

• Resolve auth: inherit at generation time and pre-populate the effective auth type (e.g. Bearer Token) from the nearest parent folder or collection, or
• Add inherit as a formal type in the OpenCollection schema and have the doc generator resolve the inheritance chain at runtime using the collection auth config embedded in the HTML

Actual behavior

• inherit is not defined in the OpenCollection schema's auth field
• The "Inherit" option is absent from the auth type dropdown in the generated HTML docs
• The auth type defaults to "No Auth" in the generated docs
• The folder level correctly shows the inherited auth note, but the request level does not
• Bruno the app correctly resolves auth: inherit at runtime — this is purely a schema and doc generation issue

Screenshots

attached below in the screenshots section

Additional context

A related issue exists where inherited auth is also missing from generated cURL output (#6269), suggesting this is a broader gap in how auth: inherit is handled across Bruno's export and generation features. The underlying fix likely needs to start with formalizing inherit in the OpenCollection spec before the doc generator can be updated to handle it correctly.

• Collection format: OpenCollection

.bru file to reproduce the bug

info:
  name: Get Scan Details
  type: http
  seq: 11

http:
  method: GET
  url: "{{url}}/v2/staff/scan/{{scanId}}"
  auth: inherit

runtime:
  variables:
    - name: scanId
      value: 6a2edef2-2165-421d-bea1-16e5tg13d6a4

settings:
  encodeUrl: true
  timeout: 0
  followRedirects: true
  maxRedirects: 5

Screenshots/Live demo link

In bruno app

in the autogenerated html

the schema from the opencollection docs

[coderabbitai]

🔗 Related PRs

#8136 - fix(generate-code)!: generate code URL issues [merged]
#8494 - fix(converters): add missing auth mappings on postman export, add additional parameters mapping on postman import [merged]
#8534 - test(converters): add round trip tests for Postman <-> Bruno converters [merged]
#8751 - feat(client certs): add global client certs and allow disabling individual client certs. [open]
#8766 - fix(timeline): headers info in response timeline [open]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[the-halfbloodprince]

On further investingation, it seems it might be exactly due to this #7764

Update

Even with auth being placed inside runtime, it works in Bruno app, Bruno VS Code extension but not in the generated HTML

new yml I tried:

info:
  name: Get Scan Details
  type: http
  seq: 11

http:
  method: GET
  url: "{{url}}/v2/staff/scan/{{scanId}}"

runtime:
  variables:
    - name: scanId
      value: 6a2edef2-2165-421d-bea1-16e5tg13d6a4
  auth: inherit

settings:
  encodeUrl: true
  timeout: 0
  followRedirects: true
  maxRedirects: 5

[abhishek-bruno]

Hi @the-halfbloodprince, this is fixed by usebruno/bruno-api-docs#7 and will be available with Bruno v4.1.0. Closing the issue. Thanks for the detailed report.