update http semantics of api