Updated API documentation

Test Plan: Review docs

Reviewers: mg

Differential Revision: https://review.inboxapp.com/D118
Swapping out account terminology for namespaces in documentation, adding detail around drafts and message delivery.