Read spans
Returns the content of 1 to 50 spans that Search objects, Answer a question, or a run returned, with one result for each span, in order. include names the parts: text (the default) is the text of a document, or the speech of a video or a recording with its lines. raw is the span cut from the object in its own format: a PDF of the pages, the text of a text file or a mail, the image, or a clip. object is the whole object version. delivery inline (the default) returns binary parts as base64 data, up to 20 MiB a call, and a url past that. url returns every binary part as a url, which works until its expiresAt. A large span returns in parts: the result span is the part returned, and next is the body of the next read, or null. A span that cannot be read has an error on its own result: not_found, invalid_span (the span does not fit the object), or content_unavailable (the content is not stored or cannot be read). The other spans still read. Requires the viewer role. Send the target of the search: a bucket or a dataset.
/v1/workspaces/{workspaceId}/read-spansAuthentication
Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.
Authorization: Bearer <GRAPHON_API_KEY>Path parameters
workspaceIdstringThe workspace id.
Request body
targetstringWhat to query: a bucket id (bkt…) of this workspace with indexing enabled, or a dataset id (dst…) from List datasets.
spansSpan[]The spans to read, 1 to 50, unchanged, as Search objects, Answer a question, or a run returned them.
includeReadInclude[] (optional)The parts to return for each span. Each fills the result field of the same name. Defaults to text.
deliveryDelivery (optional)inline: each binary part as base64 data, up to 20 MiB a call in span order, and a url past that. url: each binary part as a url. One of: inline, url.