add docs on responses