(doc) adds initial description of REST endpoints