I've been doing some work storing our build information in Confluence using the remote API. I update a row in a table indicating build information. Users can subscribe to get page updates. The Confluence email functionality currently indicates the revision comment at the top of the email. That's great and I want to exploit that functionality. When I store a page I want the option to supply a revision comment.

Please note that I'm not asking about adding a comment to a page. I know that functionality already exists. This request is for adding a comment to the revision of the page being stored. These are the comments that are visible when you take a look at the change history of a page.

Thanks!