[Reviewer: Ellie] Update API docs to cover specific numbers

Updates the Ellis API docs to cover the feature I added in https://github.com/Metaswitch/ellis/pull/61.

I've also deleted two parts where we described function we hadn't implemented - I thought this was confusing.