Rest doc updates

Additional docs for #432 
Maybe this should be listed as an option under `/v2/apps` rather than have its own header? The response is otherwise the same.