api doc: updates