api: document the path APIs