api doc clarification