document api a bit, accept a hash instead of data blob