[b] updated api docs and notes, updated frontend code --> does not work yet
[b] updated api docs and notes, updated frontend code --> does not work yet