extend plumbing out to API.