read document
A library document’s text: one saved here, an uploaded PDF, Word, PowerPoint or text file, or a transcribed recording. 60,000 characters at a time; cut_short says where a read stopped and next_cursor reads on; truncated says only the beginning of the file was ever read. An editable document returns its revision for save_document if_revision. A document nobody has read yet says so; one only on somebody’s computer names the machine. Free.
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the key's own.

