Update api-design.md

Moved design out of S-42968