Nick and Beat, I know you are very busy, but can you please answer this simple question please? Or any other developer that know how the CB API works.
The documentation needs to be reviewed. I'm a developer myself, I know how boring it is to write documentation. It's precious development time wasted... I know!