[api] support passing in an array instead of fetching from `_all_dbs`
[doc] add docs for passing in array