revised python_api doc