# Read

> Tag 2: the client names one file of the container; the server opens the proxy’s /filesystem/read and relays the bytes as channel responses, an error last when the read fails, and the channel response finish.

Canonical: https://provider.diverge.network/2.3.0/endpoints/containers-tools-connect/client/read/
Specification revision: 2.3.0

The client opens this channel to read one file out of the container.
The server opens [`/filesystem/read`](/2.3.0/proxy/filesystem/read/) on the
proxy, naming the file, and relays what the proxy sends.

- **The request.** The tag byte `2` followed by the path of the file
  as JSON. [Request](/2.3.0/endpoints/containers-tools-connect/client/read/request/) states its form.
- **The response.** The bytes of the file in one or more channel
  responses, or an error last, and the channel response finish.
  [Response](/2.3.0/endpoints/containers-tools-connect/client/read/response/) states the sequence.
- **Whole, from the beginning.** The server asks the proxy for the
  whole file. No offset and no length is carried, and the server
  states no length.