clarification on api doc