[DataAvailability] Revisit godocs and error handling in stream API backends

[illia-malachyn]

We should revisit godocs written to API handlers to make sure they are compliant with the polling endpoint handlers. This issue covers the last items of #7657 and #7658