(#22110) document catalog endpoint

Note this can't be merged as-is if only because it reintroduces the json-schema gem, which would break windows spec tests.  So this pull is for review purposes only.