updated API documentation to reflect throttling headers