Skip to content

Comments

feat: Generate MyAccount API assets#650

Open
agiannelli-auth0 wants to merge 8 commits intomainfrom
feat/DM-289
Open

feat: Generate MyAccount API assets#650
agiannelli-auth0 wants to merge 8 commits intomainfrom
feat/DM-289

Conversation

@agiannelli-auth0
Copy link
Contributor

@agiannelli-auth0 agiannelli-auth0 commented Feb 19, 2026

Description

This PR begins the process of implementing MyAccount API in Mintlify.

Changes:

  • Updated script to:
  • First run of the script to generate MyAccount API pages

References

https://auth0team.atlassian.net/browse/DM-289

Testing

Video of local MyAccount API running

Screen.Recording.2026-02-20.at.2.15.27.PM.mov

Video of MyAccount API proxied through docs-backend with docs_explorer_mintlify_myaccount_enabled FF on and off. Flag is initially off and you see the v1 experience. With the flag on, you see the v2 experience
NOTE: This video was take prior to some additional work on the MyAccount pages themselves. Reference video above for latest look & feel.

Screen.Recording.2026-02-19.at.4.34.28.PM.mov

Checklist

  • I've read and followed CONTRIBUTING.md.
  • I've tested the site build for this change locally.
  • I've made appropriate docs updates for any code or config changes.
  • I've coordinated with the Product Docs and/or Docs Management team about non-trivial changes.

@@ -0,0 +1,9 @@
---
openapi: docs/oas/myaccount/myaccount-api-oas.fr-ca.json post /authentication-methods/{authentication_method_id}/verify
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Question: I noticed this points to a file that doesn't exist (myaccount-api-oas.fr-ca.json). My understanding is that we do not have French nor Japanese translations yet, but shouldn't this point to the English OAS (myaccount-api-oas.json) in the meantime?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch! I wonder if this is what is causing the not found errors 🤔 I will modify the script to check for the existence of a languaged oas before assigning to the page.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Question: Are there any tests for this script that we need to add/update to reflect these changes?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You read my mind! I realized last night that I did not update test coverage. I will work on that this morning 👍

@nlucero
Copy link

nlucero commented Feb 20, 2026

⚠️ I noticed the following errors in the console, though the pages load up fine.

Screenshot 2026-02-19 at 3 44 00 PM

These are probably SSR errors. Did you check the browser console when rendering these pages? Did you see any similar errors?

@agiannelli-auth0
Copy link
Contributor Author

⚠️ I noticed the following errors in the console, though the pages load up fine.
Screenshot 2026-02-19 at 3 44 00 PM

These are probably SSR errors. Did you check the browser console when rendering these pages? Did you see any similar errors?

I see this error in the browser console:

Error: A listener indicated an asynchronous response by returning true, but the message channel closed before a response was received

This is likely something internal to Mintlify that I will need to ask them about.

@agiannelli-auth0
Copy link
Contributor Author

@nlucero I don't know that the console errors are related to this, but I am still trying to identify a root cause and see if I can address.

@agiannelli-auth0
Copy link
Contributor Author

@nlucero I don't know that the console errors are related to this, but I am still trying to identify a root cause and see if I can address.

This issue is fixed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants