[rest] state machines added to documentation