modified some of the endpoint documentation