update API documentation with regard to URLs