update the example to match the new response formats
update docs