Hi, this question has come up before: REST api: delete dashboard
The statement that the API is deprecated is confusing, because as of today there isn't a planned replacement for it. The existing API will not be removed until well after a replacement API has been delivered.