The documentation of the External API has aged a little over the last 6 months. This issue is about correct and update that documentation.
This issue is being addressed by https://github.com/opencast/opencast/pull/155.