sync code w/ docs for REST endpoints