doc(api): outline of v1 API