described api methods