Slides with no text, 1-based; not stored. Deprecated: without_text.slides.
このページは役に立ちましたか?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Conare","description":"Conare stores your data and returns the right context to your AI.","colors":{"primary":"#FF0004","light":"#FF4044","dark":"#C70003"},"logo":{"light":"https://mintcdn.com/conare/42P-GM0fCHU5RWi-/logo/mark.svg?fit=max\u0026auto=format\u0026n=42P-GM0fCHU5RWi-\u0026q=85\u0026s=70c4608acedfc974bf3dd65b78d3ff08","dark":"https://mintcdn.com/conare/42P-GM0fCHU5RWi-/logo/mark-white.svg?fit=max\u0026auto=format\u0026n=42P-GM0fCHU5RWi-\u0026q=85\u0026s=4f07ed1a56685950fab5a86ca3081772","href":"https://conare.ai"},"favicon":"https://mintcdn.com/conare/42P-GM0fCHU5RWi-/favicon.png?fit=max\u0026auto=format\u0026n=42P-GM0fCHU5RWi-\u0026q=85\u0026s=b78e6d7029daad2b065d95036b6bdbb4","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","typescript","python"]},"url":"full"},"background":{"color":{"light":"#FEFEFE","dark":"#020202"}},"footer":{"socials":{"github":"https://github.com/conareai","website":"https://conare.ai"}},"search":{"prompt":"Search the docs or ask a question"},"fonts":{"heading":{"family":"Anybody"},"body":{"family":"Geist"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","assistant","chatgpt","claude","cursor","vscode","mcp","add-mcp","download-spec"],"display":"header"},"markdown":{"instructions":["Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.","The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.","Embed with model conare-embed-1; send input_type \"query\" for search queries. Rerank with conare-rerank-1.","Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.","Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt."]},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"fr","href":"fr"},{"language":"uk","href":"uk"},{"language":"ar","href":"ar"},{"language":"de","href":"de"},{"language":"es","href":"es"},{"language":"pt-BR","href":"pt-BR"},{"language":"it","href":"it"},{"language":"ja","href":"ja"},{"language":"ko","href":"ko"},{"language":"zh","href":"zh"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"conare","hasAudioNarration":false,"actualSubdomain":"conare","customDomains":["docs.conare.ai"],"gitSource":{"type":"github","owner":"conareai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adee47febccf90c95ae5a8d","collectionId":"2049a198-71da-42ec-bf44-1ed9f55a4588","liveDeploymentHistoryId":"6adee47febccf90c95ae5a8d","schemaVersion":"v3"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adee47febccf90c95ae5a8d","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"en","tag":"API reference","count":54},{"language":"ar","tag":"مرجع API","count":54},{"language":"de","tag":"API-Referenz","count":54},{"language":"es","tag":"Referencia de la API","count":54},{"language":"fr","tag":"Référence API","count":54},{"language":"it","tag":"Riferimento API","count":54},{"language":"ja","tag":"API リファレンス","count":54},{"language":"ko","tag":"API 레퍼런스","count":54},{"language":"pt-BR","tag":"Referência da API","count":54},{"language":"uk","tag":"Довідник API","count":54},{"language":"zh","tag":"API 参考","count":54},{"language":"ja","tag":"ドキュメント","count":21},{"language":"ko","tag":"문서","count":21},{"language":"zh","tag":"文档","count":21},{"language":"en","tag":"Documentation","count":16},{"language":"en","tag":"Custom sources","count":16},{"language":"ar","tag":"التوثيق","count":16},{"language":"ar","tag":"المصادر المخصصة","count":16},{"language":"de","tag":"Dokumentation","count":16},{"language":"de","tag":"Eigene Quellen","count":16},{"language":"es","tag":"Documentación","count":16},{"language":"es","tag":"Fuentes personalizadas","count":16},{"language":"fr","tag":"Documentation","count":16},{"language":"fr","tag":"Sources personnalisées","count":16},{"language":"it","tag":"Documentazione","count":16},{"language":"it","tag":"Sorgenti personalizzate","count":16},{"language":"ja","tag":"カスタムソース","count":16},{"language":"ko","tag":"커스텀 소스","count":16},{"language":"pt-BR","tag":"Documentação","count":16},{"language":"pt-BR","tag":"Fontes personalizadas","count":16},{"language":"uk","tag":"Документація","count":16},{"language":"uk","tag":"Власні джерела","count":16},{"language":"zh","tag":"自定义数据源","count":16},{"language":"en","tag":"Sources","count":10},{"language":"ar","tag":"المصادر","count":10},{"language":"de","tag":"Quellen","count":10},{"language":"es","tag":"Fuentes","count":10},{"language":"fr","tag":"Sources","count":10},{"language":"it","tag":"Sorgenti","count":10},{"language":"ja","tag":"ソース","count":10},{"language":"ko","tag":"소스","count":10},{"language":"pt-BR","tag":"Fontes","count":10},{"language":"uk","tag":"Джерела","count":10},{"language":"zh","tag":"数据源","count":10},{"language":"en","tag":"Models","count":9},{"language":"ar","tag":"النماذج","count":9},{"language":"de","tag":"Modelle","count":9},{"language":"es","tag":"Modelos","count":9},{"language":"fr","tag":"Modèles","count":9},{"language":"it","tag":"Modelli","count":9},{"language":"ja","tag":"モデル","count":9},{"language":"ko","tag":"모델","count":9},{"language":"pt-BR","tag":"Modelos","count":9},{"language":"uk","tag":"Моделі","count":9},{"language":"zh","tag":"模型","count":9},{"language":"en","tag":"Core","count":5},{"language":"en","tag":"Documents","count":5},{"language":"ar","tag":"الأساسيات","count":5},{"language":"ar","tag":"المستندات","count":5},{"language":"de","tag":"Grundlagen","count":5},{"language":"de","tag":"Dokumente","count":5},{"language":"es","tag":"Esenciales","count":5},{"language":"es","tag":"Documentos","count":5},{"language":"fr","tag":"Essentiel","count":5},{"language":"fr","tag":"Documents","count":5},{"language":"it","tag":"Fondamenti","count":5},{"language":"it","tag":"Documenti","count":5},{"language":"ja","tag":"コア","count":5},{"language":"ko","tag":"핵심","count":5},{"language":"pt-BR","tag":"Essencial","count":5},{"language":"pt-BR","tag":"Documentos","count":5},{"language":"uk","tag":"Основне","count":5},{"language":"uk","tag":"Документи","count":5},{"language":"zh","tag":"核心","count":5},{"language":"en","tag":"Files","count":4},{"language":"en","tag":"Namespaces","count":4},{"language":"ar","tag":"الملفات","count":4},{"language":"ar","tag":"مساحات الأسماء","count":4},{"language":"de","tag":"Dateien","count":4},{"language":"de","tag":"Namespaces","count":4},{"language":"es","tag":"Archivos","count":4},{"language":"es","tag":"Namespaces","count":4},{"language":"fr","tag":"Fichiers","count":4},{"language":"fr","tag":"Espaces de noms","count":4},{"language":"it","tag":"File","count":4},{"language":"it","tag":"Namespace","count":4},{"language":"ja","tag":"ファイル","count":4},{"language":"ja","tag":"ネームスペース","count":4},{"language":"ko","tag":"파일","count":4},{"language":"ko","tag":"네임스페이스","count":4},{"language":"pt-BR","tag":"Arquivos","count":4},{"language":"pt-BR","tag":"Namespaces","count":4},{"language":"uk","tag":"Файли","count":4},{"language":"uk","tag":"Простори імен","count":4},{"language":"zh","tag":"文件","count":4},{"language":"zh","tag":"命名空间","count":4},{"language":"en","tag":"Get started","count":3},{"language":"ar","tag":"البدء","count":3},{"language":"de","tag":"Erste Schritte","count":3},{"language":"es","tag":"Primeros pasos","count":3},{"language":"fr","tag":"Premiers pas","count":3},{"language":"it","tag":"Primi passi","count":3},{"language":"ja","tag":"はじめに","count":3},{"language":"ko","tag":"시작하기","count":3},{"language":"pt-BR","tag":"Primeiros passos","count":3},{"language":"uk","tag":"Початок роботи","count":3},{"language":"zh","tag":"快速开始","count":3},{"language":"ja","tag":"ツール","count":2},{"language":"ko","tag":"도구","count":2},{"language":"zh","tag":"工具","count":2}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@conare.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"ja/api-reference/files/read-a-file","slug":"/ja/api-reference/files/read-a-file","pageMetadata":{"title":"Read a file","description":"The file's latest upload: its `state` and, once `ready`, its document and parse result.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/files/{id}","href":"/ja/api-reference/files/read-a-file","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"The file’s latest upload: its \", _jsx(_components.code, {\n children: \"state\"\n }), \" and, once \", _jsx(_components.code, {\n children: \"ready\"\n }), \", its document and parse result.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Read a file","description":"The file's latest upload: its `state` and, once `ready`, its document and parse result.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/files/{id}","href":"/ja/api-reference/files/read-a-file","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getFile","tags":["Files"],"summary":"Read a file","description":"The file's latest upload: its `state` and, once `ready`, its document and parse result.","parameters":["e74a76c7-ec07-4fbd-9d26-5b7f60ac7d22"],"responses":{"200":"dc39fedf-f1b1-4eac-96b9-1149a54b5804","401":"7f953c40-00bc-4987-88fd-6618be8fdf6a","403":"2e4f7d74-3b53-4244-950a-705b450194df","404":"743b985f-37bc-4801-bff2-62f3fec55bd2"},"method":"get","type":"path","servers":["3f0ab55e-8810-4a16-a3ca-2af943a47c96"],"security":["71464246-34ab-49e2-b952-8d0b0feb58f8"],"path":"/namespaces/{namespace}/files/{id}","baseUrlOptions":["https://api.conare.ai"],"title":"Read a file","codeSamples":[],"requestExampleLanguages":["bash","typescript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{"e74a76c7-ec07-4fbd-9d26-5b7f60ac7d22":{"name":"user","in":"query","required":false,"description":"The `user` the file was uploaded with.","schema":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:@-]{0,127}$","description":"The `user` the file was uploaded with.\nA user id of yours, with at most 8 `:`; group users with `:` (`tenant-7:u_42`) and query a group by `user_prefix`.","examples":["tenant-7:u_42"],"isRequired":false,"uniqueKey":"","typeLabel":"string"}},"f45d9022-e343-4230-a6f3-8b9f031f2311":{"name":"namespace","in":"path","required":true,"description":"The namespace name.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$","description":"The namespace name.\n1-64 characters of `a-z 0-9 _ -`, starting with a letter or digit.","examples":["docs","user-42"],"isRequired":true,"uniqueKey":"","typeLabel":"string"}},"e17b4f06-0225-4c0e-843d-b92b58ac88eb":{"name":"id","in":"path","required":true,"description":"The file id an upload answered (`file_id`).","schema":{"type":"string","maxLength":120,"isRequired":true,"description":"The file id an upload answered (`file_id`).","uniqueKey":"","typeLabel":"string"}}},"responses":{"dc39fedf-f1b1-4eac-96b9-1149a54b5804":{"description":"The file.","content":{"application/json":{"schema":{"type":"object","description":"An upload of `POST /namespaces/{namespace}/files` and its outcome; the fields of its file type.","required":["file_id","type","state","ids","without_text"],"properties":{"file_id":{"type":"string","isRequired":true,"uniqueKey":"file_id","typeLabel":"string"},"type":{"type":"string","enum":["pdf","xlsx","docx","pptx","csv","tsv","txt","md","image"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"state":{"type":"string","enum":["queued","parsing","ocr","ready","failed"],"description":"`queued`, `parsing`: running. `ocr`: stored, some pages retried (`ocr_pending`). `ready`: stored. `failed`: see `error`.","isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"},"ids":{"type":"array","items":{"type":"string","uniqueKey":"ids.items.[INDEX]","typeLabel":"string"},"description":"Once `ready`: the file's one document, `[\u003csource_id>:\u003cfile_id>]` (a file uploaded before 2026-10-25 lists one per part until uploaded again).","isRequired":true,"uniqueKey":"ids","typeLabel":"string[]"},"without_text":{"type":"object","description":"Everything the file stored no text for, in one place.","required":["pages","slides","images"],"properties":{"pages":{"type":"array","items":{"type":"integer","uniqueKey":"without_text.pages.items.[INDEX]","typeLabel":"integer"},"description":"A PDF's or image's pages.","isRequired":true,"uniqueKey":"without_text.pages","typeLabel":"integer[]"},"slides":{"type":"array","items":{"type":"integer","uniqueKey":"without_text.slides.items.[INDEX]","typeLabel":"integer"},"description":"A deck's slides.","isRequired":true,"uniqueKey":"without_text.slides","typeLabel":"integer[]"},"images":{"type":"array","items":{"type":"object","description":"A picture in a Word or PowerPoint file that OCR did not turn into text.","required":["image","reason"],"properties":{"image":{"type":"integer","description":"The picture's number in reading order (per slide in a deck), as its part's `image` would be.","isRequired":true,"uniqueKey":"without_text.images.items.[INDEX].image","typeLabel":"integer"},"reason":{"type":"string","enum":["too_small","not_raster","unreadable","not_read","no_text"],"description":"`too_small`: an icon or decoration. `not_raster`: a vector picture. `unreadable`: does not decode. `not_read`: over the file's picture limit, or OCR failed. `no_text`: none found.","isRequired":true,"uniqueKey":"without_text.images.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"slide":{"type":"integer","description":"A deck's: the slide the picture is on.","uniqueKey":"without_text.images.items.[INDEX].slide","typeLabel":"integer"},"heading":{"type":"string","description":"A Word document's: the headings the picture sits under.","uniqueKey":"without_text.images.items.[INDEX].heading","typeLabel":"string"},"width":{"type":"integer","description":"With `too_small`: its width in pixels.","uniqueKey":"without_text.images.items.[INDEX].width","typeLabel":"integer"},"height":{"type":"integer","description":"With `too_small`: its height in pixels.","uniqueKey":"without_text.images.items.[INDEX].height","typeLabel":"integer"}},"uniqueKey":"without_text.images.items.[INDEX]","typeLabel":"object"},"description":"A Word document's or deck's pictures.","isRequired":true,"uniqueKey":"without_text.images","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"without_text","typeLabel":"object"},"markdown":{"type":"string","description":"Once `ready`: the whole document, as `ParseResult.markdown`.","uniqueKey":"markdown","typeLabel":"string"},"parts":{"type":"array","description":"Once `ready`: its parts, as `ParseResult.parts`.","items":{"type":"object","required":["locator","markdown","ocr","confidence"],"properties":{"locator":{"type":"object","additionalProperties":true,"description":"Where the part is, e.g. `{\"page\": 3}`, `{\"slide\": 4}`, `{\"sheet\": \"Q3\", \"rows\": \"2-41\"}` or `{\"part\": 2}`.","isRequired":true,"uniqueKey":"parts.items.[INDEX].locator","typeLabel":"object"},"markdown":{"type":"string","isRequired":true,"uniqueKey":"parts.items.[INDEX].markdown","typeLabel":"string"},"ocr":{"type":"boolean","description":"Read by OCR from the page's image, not its text layer.","isRequired":true,"uniqueKey":"parts.items.[INDEX].ocr","typeLabel":"boolean"},"confidence":{"oneOf":[{"type":"number","description":"The mean probability (0-1) of the part's OCR tokens; null when OCR gave none.","isRequired":true,"uniqueKey":"parts.items.[INDEX].confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"The mean probability (0-1) of the part's OCR tokens; null when OCR gave none.","isRequired":true,"uniqueKey":"parts.items.[INDEX].confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"parts.items.[INDEX].confidence","typeLabel":"number | null"},"blocks":{"type":"array","description":"With `layout=true`, the page's regions in reading order.","items":{"type":"object","required":["type","bbox","order","content","conf"],"properties":{"type":{"type":"string","description":"The region's kind: `title`, `text`, `list`, `table`, `image`, `header`, `footer`, `footnote`, ...","isRequired":true,"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].type","typeLabel":"string"},"bbox":{"type":"array","items":{"type":"number","uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].bbox.items.[INDEX]","typeLabel":"number"},"minItems":4,"maxItems":4,"description":"`[x0, y0, x1, y1]` as shares of the page's width and height from its top left.","isRequired":true,"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].bbox","typeLabel":"number[]"},"order":{"type":"integer","description":"Its place in the reading order.","isRequired":true,"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].order","typeLabel":"integer"},"content":{"type":"string","description":"Its text (a table as in `markdown`).","isRequired":true,"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].content","typeLabel":"string"},"conf":{"oneOf":[{"type":"number","description":"The mean probability of its tokens; null when none was given.","isRequired":true,"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].conf.oneOf.0","typeLabel":"number"},{"type":"null","description":"The mean probability of its tokens; null when none was given.","isRequired":true,"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].conf.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX].conf","typeLabel":"number | null"}},"uniqueKey":"parts.items.[INDEX].blocks.items.[INDEX]","typeLabel":"object"},"uniqueKey":"parts.items.[INDEX].blocks","typeLabel":"object[]"}},"uniqueKey":"parts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"parts","typeLabel":"object[]"},"name":{"type":"string","description":"The file's name.","uniqueKey":"name","typeLabel":"string"},"uploaded_at":{"type":"integer","description":"When the file was last uploaded or parsed, in Unix milliseconds.","uniqueKey":"uploaded_at","typeLabel":"integer"},"source_id":{"type":"string","description":"The files source of the namespace (and user): the file's document is `\u003csource_id>:\u003cfile_id>`.","uniqueKey":"source_id","typeLabel":"string"},"ocr_failed":{"type":"array","items":{"type":"integer","uniqueKey":"ocr_failed.items.[INDEX]","typeLabel":"integer"},"description":"A PDF's or image's pages OCR could not read after its retries, 1-based.","uniqueKey":"ocr_failed","typeLabel":"integer[]"},"result":{"type":"string","const":"unchanged","description":"The same bytes, name, metadata and options as the file's last parse; nothing was parsed again.","uniqueKey":"result","typeLabel":"string"},"error":{"type":"object","additionalProperties":true,"description":"`failed`: `code` and `message`.","uniqueKey":"error","typeLabel":"object"},"pages":{"type":"integer","description":"A PDF's pages, or an image's pages (a TIFF's frames).","uniqueKey":"pages","typeLabel":"integer"},"pages_without_text":{"type":"array","items":{"type":"integer","uniqueKey":"pages_without_text.items.[INDEX]","typeLabel":"integer"},"deprecated":true,"description":"Pages with no text, 1-based; not stored. Deprecated: `without_text.pages`.","uniqueKey":"pages_without_text","typeLabel":"integer[]"},"pages_ocr":{"type":"integer","deprecated":true,"description":"Pages read by OCR. Deprecated: the `parts` with `ocr: true`.","uniqueKey":"pages_ocr","typeLabel":"integer"},"images_ocr":{"type":"integer","deprecated":true,"description":"Pictures read by OCR. Deprecated: the `parts` with `ocr: true`.","uniqueKey":"images_ocr","typeLabel":"integer"},"images_without_text":{"type":"array","description":"A Word document's or deck's pictures OCR did not turn into text, with why; also in `without_text.images`.","items":{"type":"object","description":"A picture in a Word or PowerPoint file that OCR did not turn into text.","required":["image","reason"],"properties":{"image":{"type":"integer","description":"The picture's number in reading order (per slide in a deck), as its part's `image` would be.","isRequired":true,"uniqueKey":"images_without_text.items.[INDEX].image","typeLabel":"integer"},"reason":{"type":"string","enum":["too_small","not_raster","unreadable","not_read","no_text"],"description":"`too_small`: an icon or decoration. `not_raster`: a vector picture. `unreadable`: does not decode. `not_read`: over the file's picture limit, or OCR failed. `no_text`: none found.","isRequired":true,"uniqueKey":"images_without_text.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"slide":{"type":"integer","description":"A deck's: the slide the picture is on.","uniqueKey":"images_without_text.items.[INDEX].slide","typeLabel":"integer"},"heading":{"type":"string","description":"A Word document's: the headings the picture sits under.","uniqueKey":"images_without_text.items.[INDEX].heading","typeLabel":"string"},"width":{"type":"integer","description":"With `too_small`: its width in pixels.","uniqueKey":"images_without_text.items.[INDEX].width","typeLabel":"integer"},"height":{"type":"integer","description":"With `too_small`: its height in pixels.","uniqueKey":"images_without_text.items.[INDEX].height","typeLabel":"integer"}},"uniqueKey":"images_without_text.items.[INDEX]","typeLabel":"object"},"uniqueKey":"images_without_text","typeLabel":"object[]"},"ocr_pending":{"type":"array","items":{"type":"integer","uniqueKey":"ocr_pending.items.[INDEX]","typeLabel":"integer"},"description":"The pages, slides or pictures OCR is still reading, 1-based; each is stored with `ocr: true` when read.","uniqueKey":"ocr_pending","typeLabel":"integer[]"},"sheets":{"type":"integer","deprecated":true,"description":"A workbook's worksheets. Deprecated: `pages`.","uniqueKey":"sheets","typeLabel":"integer"},"slides":{"type":"integer","deprecated":true,"description":"A deck's slides. Deprecated: `pages`.","uniqueKey":"slides","typeLabel":"integer"},"slides_without_text":{"type":"array","items":{"type":"integer","uniqueKey":"slides_without_text.items.[INDEX]","typeLabel":"integer"},"deprecated":true,"description":"Slides with no text, 1-based; not stored. Deprecated: `without_text.slides`.","uniqueKey":"slides_without_text","typeLabel":"integer[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"file_id":"Q3-report.pdf","name":"Q3 report.pdf","type":"pdf","uploaded_at":1791460800000,"pages":3,"source_id":"src_4f1c2a9e0b7d4c3a8e6f1b2d","ids":["src_4f1c2a9e0b7d4c3a8e6f1b2d:Q3-report.pdf"],"state":"ready","ocr_failed":[],"without_text":{"pages":[3],"slides":[],"images":[]}},"examples":{"Example":{"title":"Example","value":{"file_id":"Q3-report.pdf","name":"Q3 report.pdf","type":"pdf","uploaded_at":1791460800000,"pages":3,"source_id":"src_4f1c2a9e0b7d4c3a8e6f1b2d","ids":["src_4f1c2a9e0b7d4c3a8e6f1b2d:Q3-report.pdf"],"state":"ready","ocr_failed":[],"without_text":{"pages":[3],"slides":[],"images":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"7f953c40-00bc-4987-88fd-6618be8fdf6a":{"description":"An error. `X-Request-Id` is also in the response headers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (429, 503).","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Stable, machine-readable, by status:\n\n- 400: `invalid_request`, `fetch_failed`, `invalid_json`, `invalid_namespace`, `invalid_id`, `invalid_metadata`, `invalid_filter`, `invalid_cursor`, `invalid`, `md5_mismatch`, `idempotency_key_required`, `invalid_path`\n- 401: `unauthorized`, `invalid_upload`\n- 402 (billed calls only): `credits_exhausted`, `spend_cap_reached`, `monthly_limit_reached`, `payment_failed`\n- 403: `forbidden`, `namespace_forbidden`, `key_scope_models_only`, `namespace_not_allowed`\n- 404: `namespace_not_found`, `document_not_found`, `source_not_found`, `model_not_found`, `key_not_found`, `file_not_found`, `parse_not_found`, `not_found`\n- 405: `method_not_allowed`\n- 409: `version_conflict`, `conflict`, `idempotency_in_progress`, `run_active`, `run_not_receiving`, `source_deleting`, `user_purging`, `upload_incomplete`, `namespace_has_sources`, `too_many_exclusions`, `push_source`, `pull_source`, `files_source`, `no_original`, `file_replaced`, `gcs_bucket_claimed`, `limit_reached`\n- 410: `upload_expired`, `model_retired`\n- 413: `payload_too_large`, `too_large`\n- 415: `unsupported_file`, `type_mismatch`, `unsupported_encoding`\n- 422: `idempotency_key_reused`, `no_text`, `unreadable_file`, `password_protected`, `gcs_access_denied`, `gcs_not_verified`, `gcs_bucket_not_found`\n- 429: `rate_limited`\n- 500: `internal_error`; 502: `upstream_error`; 501: `models_only`\n- 503: `unavailable`, `sources_unavailable`, `timeout`, `embed_unavailable`, `sync_storage_unavailable`, `sync_unconfigured`, `files_unconfigured`, `files_unavailable`, `gcs_unconfigured`, `gcs_unavailable`, `gcs_auth_failed`\n","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_request","message":"text is required","request_id":"7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"text is required","request_id":"7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"}}}},"exampleType":"examples"}},"exampleType":"examples"},"2e4f7d74-3b53-4244-950a-705b450194df":{"description":"An error. `X-Request-Id` is also in the response headers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying (429, 503).","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Stable, machine-readable, by status:\n\n- 400: `invalid_request`, `fetch_failed`, `invalid_json`, `invalid_namespace`, `invalid_id`, `invalid_metadata`, `invalid_filter`, `invalid_cursor`, `invalid`, `md5_mismatch`, `idempotency_key_required`, `invalid_path`\n- 401: `unauthorized`, `invalid_upload`\n- 402 (billed calls only): `credits_exhausted`, `spend_cap_reached`, `monthly_limit_reached`, `payment_failed`\n- 403: `forbidden`, `namespace_forbidden`, `key_scope_models_only`, `namespace_not_allowed`\n- 404: `namespace_not_found`, `document_not_found`, `source_not_found`, `model_not_found`, `key_not_found`, `file_not_found`, `parse_not_found`, `not_found`\n- 405: `method_not_allowed`\n- 409: `version_conflict`, `conflict`, `idempotency_in_progress`, `run_active`, `run_not_receiving`, `source_deleting`, `user_purging`, `upload_incomplete`, `namespace_has_sources`, `too_many_exclusions`, `push_source`, `pull_source`, `files_source`, `no_original`, `file_replaced`, `gcs_bucket_claimed`, `limit_reached`\n- 410: `upload_expired`, `model_retired`\n- 413: `payload_too_large`, `too_large`\n- 415: `unsupported_file`, `type_mismatch`, `unsupported_encoding`\n- 422: `idempotency_key_reused`, `no_text`, `unreadable_file`, `password_protected`, `gcs_access_denied`, `gcs_not_verified`, `gcs_bucket_not_found`\n- 429: `rate_limited`\n- 500: `internal_error`; 502: `upstream_error`; 501: `models_only`\n- 503: `unavailable`, `sources_unavailable`, `timeout`, `embed_unavailable`, `sync_storage_unavailable`, `sync_unconfigured`, `files_unconfigured`, `files_unavailable`, `gcs_unconfigured`, `gcs_unavailable`, `gcs_auth_failed`\n","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_request","message":"text is required","request_id":"7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"text is required","request_id":"7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"}}}},"exampleType":"examples"}},"exampleType":"examples"},"743b985f-37bc-4801-bff2-62f3fec55bd2":{"description":"`file_not_found`: no file of this id in the namespace (and user).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"Stable, machine-readable, by status:\n\n- 400: `invalid_request`, `fetch_failed`, `invalid_json`, `invalid_namespace`, `invalid_id`, `invalid_metadata`, `invalid_filter`, `invalid_cursor`, `invalid`, `md5_mismatch`, `idempotency_key_required`, `invalid_path`\n- 401: `unauthorized`, `invalid_upload`\n- 402 (billed calls only): `credits_exhausted`, `spend_cap_reached`, `monthly_limit_reached`, `payment_failed`\n- 403: `forbidden`, `namespace_forbidden`, `key_scope_models_only`, `namespace_not_allowed`\n- 404: `namespace_not_found`, `document_not_found`, `source_not_found`, `model_not_found`, `key_not_found`, `file_not_found`, `parse_not_found`, `not_found`\n- 405: `method_not_allowed`\n- 409: `version_conflict`, `conflict`, `idempotency_in_progress`, `run_active`, `run_not_receiving`, `source_deleting`, `user_purging`, `upload_incomplete`, `namespace_has_sources`, `too_many_exclusions`, `push_source`, `pull_source`, `files_source`, `no_original`, `file_replaced`, `gcs_bucket_claimed`, `limit_reached`\n- 410: `upload_expired`, `model_retired`\n- 413: `payload_too_large`, `too_large`\n- 415: `unsupported_file`, `type_mismatch`, `unsupported_encoding`\n- 422: `idempotency_key_reused`, `no_text`, `unreadable_file`, `password_protected`, `gcs_access_denied`, `gcs_not_verified`, `gcs_bucket_not_found`\n- 429: `rate_limited`\n- 500: `internal_error`; 502: `upstream_error`; 501: `models_only`\n- 503: `unavailable`, `sources_unavailable`, `timeout`, `embed_unavailable`, `sync_storage_unavailable`, `sync_unconfigured`, `files_unconfigured`, `files_unavailable`, `gcs_unconfigured`, `gcs_unavailable`, `gcs_auth_failed`\n","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"71464246-34ab-49e2-b952-8d0b0feb58f8":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk-conare-…","description":"A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (`/embed`, `/rerank`, `/v1`, `/v2/rerank`, `/parse`).","scopes":[],"schemeName":"apiKey"}}},"servers":{"3f0ab55e-8810-4a16-a3ca-2af943a47c96":{"url":"https://api.conare.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"sk-conare-…","description":"A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (`/embed`, `/rerank`, `/v1`, `/v2/rerank`, `/parse`).","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (`/embed`, `/rerank`, `/v1`, `/v2/rerank`, `/parse`).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"conare","siteName":"Conare","title":"Read a file - Conare","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/files/read-a-file","matchLevel":1},"fr":{"href":"/fr/api-reference/files/read-a-file","matchLevel":1},"uk":{"href":"/uk/api-reference/files/read-a-file","matchLevel":1},"ar":{"href":"/ar/api-reference/files/read-a-file","matchLevel":1},"de":{"href":"/de/api-reference/files/read-a-file","matchLevel":1},"es":{"href":"/es/api-reference/files/read-a-file","matchLevel":1},"pt-BR":{"href":"/pt-br/api-reference/files/read-a-file","matchLevel":1},"it":{"href":"/it/api-reference/files/read-a-file","matchLevel":1},"ja":{"href":"/ja/api-reference/files/read-a-file","matchLevel":0},"ko":{"href":"/ko/api-reference/files/read-a-file","matchLevel":1},"zh":{"href":"/zh/api-reference/files/read-a-file","matchLevel":1}}},"lastModified":"2026-10-26T05:21:43.878Z","originalFileLocation":"ja/api-reference/files/read-a-file.mdx","locale":"ja"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The file\u0026#x27;s latest upload: its state and, once ready, its document and parse result.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Conare\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read a file - Conare\">\u003cmeta data-mint-head property=\"og:description\" content=\"The file\u0026#x27;s latest upload: its state and, once ready, its document and parse result.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Conare\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.conare.ai/ja/api-reference/files/read-a-file\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://conare.mintlify.app/_mintlify/api/og/v2?division=%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB\u0026amp;title=Read+a+file\u0026amp;description=The+file%27s+latest+upload%3A+its+%60state%60+and%2C+once+%60ready%60%2C+its+document+and+parse+result.\u0026amp;theme=40abca5b8ae3067f606efc2d\u0026amp;signature=a60c76ba33191951a32ab4d89d8fe2a494743338b49dac8c2cc5b301dfc373b0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Read a file - Conare\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The file\u0026#x27;s latest upload: its state and, once ready, its document and parse result.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://conare.mintlify.app/_mintlify/api/og/v2?division=%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB\u0026amp;title=Read+a+file\u0026amp;description=The+file%27s+latest+upload%3A+its+%60state%60+and%2C+once+%60ready%60%2C+its+document+and+parse+result.\u0026amp;theme=40abca5b8ae3067f606efc2d\u0026amp;signature=a60c76ba33191951a32ab4d89d8fe2a494743338b49dac8c2cc5b301dfc373b0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/conare/-Fmwv9ex_Ks8xfwe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Conare\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF0004\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.conare.ai/ja/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ja/api-reference/files/read-a-file.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.conare.ai/ja/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.conare.ai/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.conare.ai/fr/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"uk\" href=\"https://docs.conare.ai/uk/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.conare.ai/ar/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.conare.ai/de/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.conare.ai/es/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.conare.ai/pt-br/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.conare.ai/it/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.conare.ai/ko/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.conare.ai/zh/api-reference/files/read-a-file\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.conare.ai/api-reference/files/read-a-file\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.conare.ai/#organization\",\"name\":\"Conare\",\"url\":\"https://docs.conare.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/conare/42P-GM0fCHU5RWi-/logo/mark.svg?fit=max\u0026auto=format\u0026n=42P-GM0fCHU5RWi-\u0026q=85\u0026s=70c4608acedfc974bf3dd65b78d3ff08\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.conare.ai#website\",\"name\":\"Conare\",\"url\":\"https://docs.conare.ai\",\"publisher\":{\"@id\":\"https://docs.conare.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file#webpage\",\"url\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file\",\"name\":\"Read a file\",\"description\":\"The file's latest upload: its state and, once ready, its document and parse result.\",\"dateModified\":\"2026-10-26T05:21:43.878Z\",\"isPartOf\":{\"@id\":\"https://docs.conare.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"ファイル\",\"item\":\"https://docs.conare.ai/ja/api-reference/files/upload-a-file\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Read a file\",\"item\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file#apireference\",\"headline\":\"Read a file\",\"name\":\"Read a file\",\"description\":\"The file's latest upload: its state and, once ready, its document and parse result.\",\"url\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file\",\"mainEntityOfPage\":{\"@id\":\"https://docs.conare.ai/ja/api-reference/files/read-a-file#webpage\"},\"dateModified\":\"2026-10-26T05:21:43.878Z\",\"publisher\":{\"@id\":\"https://docs.conare.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.conare.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Conare\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Conare","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/api-reference/files/read-a-file"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/files/read-a-file"}]},{"language":"uk","pages":[{"title":"uk","href":"/uk/api-reference/files/read-a-file"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/api-reference/files/read-a-file"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/files/read-a-file"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/files/read-a-file"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-br/api-reference/files/read-a-file"}]},{"language":"it","pages":[{"title":"it","href":"/it/api-reference/files/read-a-file"}]},{"language":"ja","tabs":[{"tab":"ドキュメント","icon":"book-open","pages":[{"title":"ドキュメント","href":"/ja"}]},{"tab":"API リファレンス","icon":"square-terminal","groups":[{"group":"概要","pages":[{"title":"API の概要","sidebarTitle":"はじめに","href":"/ja/api"}]},{"group":"ネームスペース","pages":[{"title":"List namespaces","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces","href":"/ja/api-reference/namespaces/list-namespaces"},{"title":"Create a namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces","href":"/ja/api-reference/namespaces/create-a-namespace"},{"title":"Get a namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}","href":"/ja/api-reference/namespaces/get-a-namespace"},{"title":"Delete a namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /namespaces/{namespace}","href":"/ja/api-reference/namespaces/delete-a-namespace"}]},{"group":"ドキュメント","pages":[{"title":"Add documents","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces/{namespace}/documents","href":"/ja/api-reference/documents/add-documents"},{"title":"List documents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/documents","href":"/ja/api-reference/documents/list-documents"},{"title":"Get a document","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/documents/{id}","href":"/ja/api-reference/documents/get-a-document"},{"title":"Delete a document","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /namespaces/{namespace}/documents/{id}","href":"/ja/api-reference/documents/delete-a-document"},{"title":"Delete documents by id or filter","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces/{namespace}/documents/delete","href":"/ja/api-reference/documents/delete-documents-by-id-or-filter"}]},{"group":"検索","pages":[{"title":"Query a namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces/{namespace}/query","href":"/ja/api-reference/query/query-a-namespace"},{"title":"Query every namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml post /query","href":"/ja/api-reference/query/query-every-namespace"}]},{"group":"ファイル","pages":[{"title":"Upload a file","description":"Stores a file as one searchable document, `\u003csource_id>:\u003cfile_id>`. Its pages, slides, worksheet row ranges and sections are its parts: a search hit carries where it is in its metadata (`page`; `sheet` and `rows`; `slide`; `part`, `heading` and `lines`; `frame`; `image`), and a search answers a PDF's or image's page, a slide or a sheet's row range as a result of its own, its id `\u003csource_id>:\u003cfile_id>$\u003cpart>` (`page-3`, `slide-4`, ...), which `GET /namespaces/{namespace}/documents/{id}` reads alone; a text, Markdown or Word file is one result, the file. Uploading the same `id` again replaces it; the same bytes, name, metadata and options answer `result: unchanged`.\n\n- Body: the file's bytes, a multipart `file` part, or JSON `{\"url\": \"https://...\"}`, up to 512 MiB and 5,000 pages, sheets or slides.\n- Answers 200 once the parse ends within `wait` seconds, else 202: follow it with `GET /namespaces/{namespace}/files/{id}`.\n- The document's id is `\u003csource_id>:\u003cfile_id>`; a file uploaded before 2026-10-25 keeps one document per part, `\u003csource_id>:\u003cfile_id>:\u003cpart>`, until it is uploaded again. Every PDF page and image is read by OCR.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces/{namespace}/files","href":"/ja/api-reference/files/upload-a-file"},{"title":"Read a file","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/files/{id}","href":"/ja/api-reference/files/read-a-file"}]},{"group":"解析","pages":[{"title":"Parse a file to Markdown","description":"Parses a file as `POST /namespaces/{namespace}/files` does and returns its Markdown and parts, storing nothing. Any key can call it, a models-only key included.\n\n- Body: the file's bytes or JSON `{\"url\": \"https://...\"}`, up to 512 MiB and 5,000 pages; send a JSON file as `text/plain`.\n- A file OCR reads, or a large one (over 20 MiB or 2,000 pages, or over 100 pages for OCR), answers 202 with an `id` when not done within `wait`.\n- Read a 202's result with `GET /parse/{id}`, kept 24 hours.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /parse","href":"/ja/api-reference/parse/parse-a-file-to-markdown"},{"title":"Get a parse result","deprecated":null,"version":null,"openapi":"/openapi.yaml get /parse/{id}","href":"/ja/api-reference/parse/get-a-parse-result"}]},{"group":"ソース","pages":[{"title":"List source types","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/types","href":"/ja/api-reference/sources/list-source-types"},{"title":"Connect a source","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources","href":"/ja/api-reference/sources/connect-a-source"},{"title":"List sources","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources","href":"/ja/api-reference/sources/list-sources"},{"title":"Get a source","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/{id}","href":"/ja/api-reference/sources/get-a-source"},{"title":"Set how often a source syncs","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /sources/{id}","href":"/ja/api-reference/sources/set-how-often-a-source-syncs"},{"title":"Sync a source now","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/sync","href":"/ja/api-reference/sources/sync-a-source-now"},{"title":"Disconnect a source","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /sources/{id}","href":"/ja/api-reference/sources/disconnect-a-source"},{"title":"Get the bucket service account","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/gcs","href":"/ja/api-reference/sources/get-the-bucket-service-account"},{"title":"Preview a bucket","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/gcs/preview","href":"/ja/api-reference/sources/preview-a-bucket"},{"title":"List a source's failures","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/{id}/failures","href":"/ja/api-reference/sources/list-a-sources-failures"}]},{"group":"カスタムソース","pages":[{"title":"Push documents","deprecated":null,"version":null,"openapi":"/openapi.yaml put /sources/{id}/documents","href":"/ja/api-reference/custom-sources/push-documents"},{"title":"List a source's documents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/{id}/documents","href":"/ja/api-reference/custom-sources/list-a-sources-documents"},{"title":"Get a source's document","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/{id}/documents/{key}","href":"/ja/api-reference/custom-sources/get-a-sources-document"},{"title":"Check which documents to push","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/documents/check","href":"/ja/api-reference/custom-sources/check-which-documents-to-push"},{"title":"Delete a source's documents","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/documents/delete","href":"/ja/api-reference/custom-sources/delete-a-sources-documents"},{"title":"Restore excluded documents","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/documents/restore","href":"/ja/api-reference/custom-sources/restore-excluded-documents"},{"title":"Open a snapshot run","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/runs","href":"/ja/api-reference/custom-sources/open-a-snapshot-run"},{"title":"Import an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/imports","href":"/ja/api-reference/custom-sources/import-an-upload"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/openapi.yaml get /runs/{id}","href":"/ja/api-reference/custom-sources/get-a-run"},{"title":"Complete a snapshot run","deprecated":null,"version":null,"openapi":"/openapi.yaml post /runs/{id}/complete","href":"/ja/api-reference/custom-sources/complete-a-snapshot-run"},{"title":"List an import's results","deprecated":null,"version":null,"openapi":"/openapi.yaml get /runs/{id}/results","href":"/ja/api-reference/custom-sources/list-an-imports-results"},{"title":"List an import's failures","deprecated":null,"version":null,"openapi":"/openapi.yaml get /runs/{id}/failures","href":"/ja/api-reference/custom-sources/list-an-imports-failures"},{"title":"Start an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /uploads","href":"/ja/api-reference/custom-sources/start-an-upload"},{"title":"Get an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml get /uploads/{id}","href":"/ja/api-reference/custom-sources/get-an-upload"},{"title":"Send a part","deprecated":null,"version":null,"openapi":"/openapi.yaml put /uploads/{id}/parts/{n}","href":"/ja/api-reference/custom-sources/send-a-part"},{"title":"Complete an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /uploads/{id}/complete","href":"/ja/api-reference/custom-sources/complete-an-upload"}]},{"group":"モデル","pages":[{"title":"Embed texts (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/embeddings","href":"/ja/api-reference/models/embed-texts-openai-compatible"},{"title":"Rerank documents (Cohere- and vLLM-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/rerank","href":"/ja/api-reference/models/rerank-documents-cohere-and-vllm-compatible"},{"title":"Rerank documents (Cohere v2-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v2/rerank","href":"/ja/api-reference/models/rerank-documents-cohere-v2-compatible"},{"title":"List models (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/models","href":"/ja/api-reference/models/list-models-openai-compatible"},{"title":"Retrieve a model (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/models/{id}","href":"/ja/api-reference/models/retrieve-a-model-openai-compatible"},{"title":"Embed texts","deprecated":null,"version":null,"openapi":"/openapi.yaml post /embed","href":"/ja/api-reference/models/embed-texts"},{"title":"Rerank documents","deprecated":null,"version":null,"openapi":"/openapi.yaml post /rerank","href":"/ja/api-reference/models/rerank-documents"}]},{"group":"ユーザー","pages":[{"title":"Delete a user's data","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users/{user}","href":"/ja/api-reference/users/delete-a-users-data"},{"title":"Delete every user under a prefix","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users","href":"/ja/api-reference/users/delete-every-user-under-a-prefix"}]},{"group":"イベント","pages":[{"title":"List events","deprecated":null,"version":null,"openapi":"/openapi.yaml get /events","href":"/ja/api-reference/events/list-events"}]},{"group":"組織","pages":[{"title":"List organizations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /organizations","href":"/ja/api-reference/organizations/list-organizations"}]},{"group":"ヘルスチェック","pages":[{"title":"Deep health check","deprecated":null,"version":null,"openapi":"/openapi.yaml get /health/deep","href":"/ja/api-reference/health/deep-health-check"}]}]}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/files/read-a-file"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/files/read-a-file"}]}]},"title":"Read a file - Conare","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}