Update docs/api-subscription.md

Fixing docs based on customer feedback.