documenting http api