:notebook: adding api methods