Leaving a note here so that we don't forget: we are going to want to document this API.