I have updated the REST API docs/examples at https://github.com/rhq-project/rhq-metrics/tree/master/rest-servlet. They are neither comprehensive nor complete, but they now do better reflect the current code base and what will be in the next development release.