Перейти до основного вмісту
GET
Read a file

Авторизації

Authorization
string
header
обов'язково

A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (/embed, /rerank, /v1, /v2/rerank, /parse).

Параметри шляху

namespace
string
обов'язково

The namespace name. 1-64 characters of a-z 0-9 _ -, starting with a letter or digit.

Pattern: ^[a-z0-9][a-z0-9_-]{0,63}$
Приклади:

"docs"

"user-42"

id
string
обов'язково

The file id an upload answered (file_id).

Maximum string length: 120

Параметри запиту

user
string

The user the file was uploaded with. A user id of yours, with at most 8 :; group users with : (tenant-7:u_42) and query a group by user_prefix.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:@-]{0,127}$
Приклад:

"tenant-7:u_42"

Відповідь

The file.

An upload of POST /namespaces/{namespace}/files and its outcome; the fields of its file type.

file_id
string
обов'язково
type
enum<string>
обов'язково
Доступні опції:
pdf,
xlsx,
docx,
pptx,
csv,
tsv,
txt,
md,
image
state
enum<string>
обов'язково

queued, parsing: running. ocr: stored, some pages retried (ocr_pending). ready: stored. failed: see error.

Доступні опції:
queued,
parsing,
ocr,
ready,
failed
ids
string[]
обов'язково

Once ready: the file's one document, [<source_id>:<file_id>] (a file uploaded before 2026-10-25 lists one per part until uploaded again).

without_text
object
обов'язково

Everything the file stored no text for, in one place.

markdown
string

Once ready: the whole document, as ParseResult.markdown.

parts
object[]

Once ready: its parts, as ParseResult.parts.

name
string

The file's name.

uploaded_at
integer

When the file was last uploaded or parsed, in Unix milliseconds.

source_id
string

The files source of the namespace (and user): the file's document is <source_id>:<file_id>.

ocr_failed
integer[]

A PDF's or image's pages OCR could not read after its retries, 1-based.

result
string

The same bytes, name, metadata and options as the file's last parse; nothing was parsed again.

Allowed value: "unchanged"
error
object

failed: code and message.

pages
integer

A PDF's pages, or an image's pages (a TIFF's frames).

pages_without_text
integer[]
застаріло

Pages with no text, 1-based; not stored. Deprecated: without_text.pages.

pages_ocr
integer
застаріло

Pages read by OCR. Deprecated: the parts with ocr: true.

images_ocr
integer
застаріло

Pictures read by OCR. Deprecated: the parts with ocr: true.

images_without_text
object[]

A Word document's or deck's pictures OCR did not turn into text, with why; also in without_text.images.

ocr_pending
integer[]

The pages, slides or pictures OCR is still reading, 1-based; each is stored with ocr: true when read.

sheets
integer
застаріло

A workbook's worksheets. Deprecated: pages.

slides
integer
застаріло

A deck's slides. Deprecated: pages.

slides_without_text
integer[]
застаріло

Slides with no text, 1-based; not stored. Deprecated: without_text.slides.