Nice! Well, honestly it’s a component of the gotrue library and would probably be documented as part of the HTTP API there, but there’s not very much documentation directly on
gotrue itself anywhere. So I suppose it’d be best added to the gotrue-js README, where most of the documentation around GoTrue lives.
Not sure what policies around open source contributions to Netlify OSS READMEs are, but I’d love to PR that whole Readme Also not sure what the roadmap for GoTrue altogether is (why I’ve been hesitant to contribute to the project previously!) but if it is going to be around and utilized for a good long while, I’d be happy to help!