docs: correct detailed api contracts and modernize response models
Updated Detailed API Documentation (markdown)
Created Detailed API Documentation (markdown)