[minor] API resources cleanup

minor changes to the API resources & documents