{"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":"zh/api-reference/sources/preview-a-bucket","slug":"/zh/api-reference/sources/preview-a-bucket","pageMetadata":{"title":"Preview a bucket","description":"Counts what a Google Cloud Storage source of the bucket would read, storing nothing.\n\n- Lists at most 10,000 objects in 10 seconds (`complete: false` past either).\n- The bucket must hold `.conare/\u003corganization id>` (422 `gcs_not_verified`); a key scoped to namespaces is 403.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/gcs/preview","href":"/zh/api-reference/sources/preview-a-bucket","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Counts what a Google Cloud Storage source of the bucket would read, storing nothing.\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"Lists at most 10,000 objects in 10 seconds (\", _jsx(_components.code, {\n children: \"complete: false\"\n }), \" past either).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"The bucket must hold \", _jsx(_components.code, {\n children: \".conare/\u003corganization id>\"\n }), \" (422 \", _jsx(_components.code, {\n children: \"gcs_not_verified\"\n }), \"); a key scoped to namespaces is 403.\"]\n }), \"\\n\"]\n })]\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":"Preview a bucket","description":"Counts what a Google Cloud Storage source of the bucket would read, storing nothing.\n\n- Lists at most 10,000 objects in 10 seconds (`complete: false` past either).\n- The bucket must hold `.conare/\u003corganization id>` (422 `gcs_not_verified`); a key scoped to namespaces is 403.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/gcs/preview","href":"/zh/api-reference/sources/preview-a-bucket","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"previewGCSSource","tags":["Sources"],"summary":"Preview a bucket","description":"Counts what a Google Cloud Storage source of the bucket would read, storing nothing.\n\n- Lists at most 10,000 objects in 10 seconds (`complete: false` past either).\n- The bucket must hold `.conare/\u003corganization id>` (422 `gcs_not_verified`); a key scoped to namespaces is 403.\n","requestBody":"2fd0920f-1540-4090-aa02-533cdbe01d52","responses":{"200":"c7e849b6-0856-4d98-9696-de3688a66e39","400":"20666af0-6424-4f93-97e9-bdba29258ad5","401":"79603e86-8e03-40a6-8716-35d797b38ce3","422":"84b3cb6f-3b23-4b07-b1ad-c0fc82ea39c4","503":"6307178a-de9b-427e-a2ea-9e4ac40ed998"},"method":"post","type":"path","servers":["3f0ab55e-8810-4a16-a3ca-2af943a47c96"],"security":["71464246-34ab-49e2-b952-8d0b0feb58f8"],"path":"/sources/gcs/preview","baseUrlOptions":["https://api.conare.ai"],"title":"Preview a bucket","codeSamples":[],"requestExampleLanguages":["bash","typescript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bucket"],"additionalProperties":false,"properties":{"bucket":{"type":"string","description":"The bucket's name (gs:// is taken off).","isRequired":true,"uniqueKey":"bucket","typeLabel":"string"},"prefixes":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":1024,"uniqueKey":"prefixes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"prefixes","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"bucket":"acme-reports","prefixes":["2024/"]},"examples":{"Example":{"title":"Example","value":{"bucket":"acme-reports","prefixes":["2024/"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"c7e849b6-0856-4d98-9696-de3688a66e39":{"description":"The counts.","content":{"application/json":{"schema":{"type":"object","required":["service_account","bucket","prefixes","objects","bytes","types","skipped","unsupported","too_large","sample","complete"],"properties":{"service_account":{"type":"string","isRequired":true,"uniqueKey":"service_account","typeLabel":"string"},"bucket":{"type":"string","isRequired":true,"uniqueKey":"bucket","typeLabel":"string"},"prefixes":{"type":"array","items":{"type":"string","uniqueKey":"prefixes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"prefixes","typeLabel":"string[]"},"objects":{"type":"integer","format":"int64","description":"The files a source would read.","isRequired":true,"uniqueKey":"objects","typeLabel":"integer\u003cint64>"},"bytes":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"bytes","typeLabel":"integer\u003cint64>"},"types":{"type":"object","additionalProperties":{"type":"integer","uniqueKey":"types.additionalProperties","typeLabel":"integer"},"description":"Files by declared type (`pdf`, `docx`, ...); `other` when only the bytes will tell.","isRequired":true,"uniqueKey":"types","typeLabel":"object"},"skipped":{"type":"integer","format":"int64","description":"Folders and empty objects.","isRequired":true,"uniqueKey":"skipped","typeLabel":"integer\u003cint64>"},"unsupported":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"unsupported","typeLabel":"integer\u003cint64>"},"too_large":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"too_large","typeLabel":"integer\u003cint64>"},"sample":{"type":"array","items":{"type":"string","uniqueKey":"sample.items.[INDEX]","typeLabel":"string"},"description":"Up to 20 object names.","isRequired":true,"uniqueKey":"sample","typeLabel":"string[]"},"complete":{"type":"boolean","isRequired":true,"uniqueKey":"complete","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"service_account":"\u003cstring>","bucket":"\u003cstring>","prefixes":["\u003cstring>"],"objects":123,"bytes":123,"types":{},"skipped":123,"unsupported":123,"too_large":123,"sample":["\u003cstring>"],"complete":true}}},"exampleType":"generated"}},"exampleType":"generated"},"20666af0-6424-4f93-97e9-bdba29258ad5":{"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"},"79603e86-8e03-40a6-8716-35d797b38ce3":{"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"},"84b3cb6f-3b23-4b07-b1ad-c0fc82ea39c4":{"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"},"6307178a-de9b-427e-a2ea-9e4ac40ed998":{"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"}},"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":"Preview a bucket - Conare","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/sources/preview-a-bucket","matchLevel":1},"fr":{"href":"/fr/api-reference/sources/preview-a-bucket","matchLevel":1},"uk":{"href":"/uk/api-reference/sources/preview-a-bucket","matchLevel":1},"ar":{"href":"/ar/api-reference/sources/preview-a-bucket","matchLevel":1},"de":{"href":"/de/api-reference/sources/preview-a-bucket","matchLevel":1},"es":{"href":"/es/api-reference/sources/preview-a-bucket","matchLevel":1},"pt-BR":{"href":"/pt-br/api-reference/sources/preview-a-bucket","matchLevel":1},"it":{"href":"/it/api-reference/sources/preview-a-bucket","matchLevel":1},"ja":{"href":"/ja/api-reference/sources/preview-a-bucket","matchLevel":1},"ko":{"href":"/ko/api-reference/sources/preview-a-bucket","matchLevel":1},"zh":{"href":"/zh/api-reference/sources/preview-a-bucket","matchLevel":0}}},"lastModified":"2026-10-26T05:21:45.281Z","originalFileLocation":"zh/api-reference/sources/preview-a-bucket.mdx","locale":"zh"},"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=\"Counts what a Google Cloud Storage source of the bucket would read, storing nothing. - Lists at most 10,000 objects in 10 seconds (complete: false past either). - The bucket must hold .conare/ (422 gcs_not_verified); a key scoped to namespaces is 403.\">\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=\"Preview a bucket - Conare\">\u003cmeta data-mint-head property=\"og:description\" content=\"Counts what a Google Cloud Storage source of the bucket would read, storing nothing. - Lists at most 10,000 objects in 10 seconds (complete: false past either). - The bucket must hold .conare/ (422 gcs_not_verified); a key scoped to namespaces is 403.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Conare\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket\">\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=%E6%95%B0%E6%8D%AE%E6%BA%90\u0026amp;title=Preview+a+bucket\u0026amp;description=Counts+what+a+Google+Cloud+Storage+source+of+the+bucket+would+read%2C+storing+nothing.%0A%0A-+Lists+at+most+10%2C000+objects+in+10+seconds+%28%60complete%3A+false%60+past+eithe\u0026amp;theme=40abca5b8ae3067f606efc2d\u0026amp;signature=cdd95355708bfcdbedf1c12c9f1ade722357a9876f86ac9559bab2c78a3b8e70\">\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=\"Preview a bucket - Conare\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Counts what a Google Cloud Storage source of the bucket would read, storing nothing. - Lists at most 10,000 objects in 10 seconds (complete: false past either). - The bucket must hold .conare/ (422 gcs_not_verified); a key scoped to namespaces is 403.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://conare.mintlify.app/_mintlify/api/og/v2?division=%E6%95%B0%E6%8D%AE%E6%BA%90\u0026amp;title=Preview+a+bucket\u0026amp;description=Counts+what+a+Google+Cloud+Storage+source+of+the+bucket+would+read%2C+storing+nothing.%0A%0A-+Lists+at+most+10%2C000+objects+in+10+seconds+%28%60complete%3A+false%60+past+eithe\u0026amp;theme=40abca5b8ae3067f606efc2d\u0026amp;signature=cdd95355708bfcdbedf1c12c9f1ade722357a9876f86ac9559bab2c78a3b8e70\">\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/zh/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/zh/api-reference/sources/preview-a-bucket.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.conare.ai/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.conare.ai/fr/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"uk\" href=\"https://docs.conare.ai/uk/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.conare.ai/ar/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.conare.ai/de/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.conare.ai/es/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.conare.ai/pt-br/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.conare.ai/it/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.conare.ai/ja/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.conare.ai/ko/api-reference/sources/preview-a-bucket\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.conare.ai/api-reference/sources/preview-a-bucket\">\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/zh/api-reference/sources/preview-a-bucket#webpage\",\"url\":\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket\",\"name\":\"Preview a bucket\",\"description\":\"Counts what a Google Cloud Storage source of the bucket would read, storing nothing. - Lists at most 10,000 objects in 10 seconds (complete: false past either). - The bucket must hold .conare/ (422 gcs_not_verified); a key scoped to namespaces is 403.\",\"dateModified\":\"2026-10-26T05:21:45.281Z\",\"isPartOf\":{\"@id\":\"https://docs.conare.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"数据源\",\"item\":\"https://docs.conare.ai/zh/api-reference/sources/list-source-types\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Preview a bucket\",\"item\":\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket#apireference\",\"headline\":\"Preview a bucket\",\"name\":\"Preview a bucket\",\"description\":\"Counts what a Google Cloud Storage source of the bucket would read, storing nothing. - Lists at most 10,000 objects in 10 seconds (complete: false past either). - The bucket must hold .conare/ (422 gcs_not_verified); a key scoped to namespaces is 403.\",\"url\":\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket\",\"mainEntityOfPage\":{\"@id\":\"https://docs.conare.ai/zh/api-reference/sources/preview-a-bucket#webpage\"},\"dateModified\":\"2026-10-26T05:21:45.281Z\",\"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/sources/preview-a-bucket"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/sources/preview-a-bucket"}]},{"language":"uk","pages":[{"title":"uk","href":"/uk/api-reference/sources/preview-a-bucket"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/api-reference/sources/preview-a-bucket"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/sources/preview-a-bucket"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/sources/preview-a-bucket"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-br/api-reference/sources/preview-a-bucket"}]},{"language":"it","pages":[{"title":"it","href":"/it/api-reference/sources/preview-a-bucket"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/api-reference/sources/preview-a-bucket"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/sources/preview-a-bucket"}]},{"language":"zh","tabs":[{"tab":"文档","icon":"book-open","pages":[{"title":"文档","href":"/zh"}]},{"tab":"API 参考","icon":"square-terminal","groups":[{"group":"概览","pages":[{"title":"API 概览","sidebarTitle":"简介","href":"/zh/api"}]},{"group":"命名空间","pages":[{"title":"List namespaces","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces","href":"/zh/api-reference/namespaces/list-namespaces"},{"title":"Create a namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces","href":"/zh/api-reference/namespaces/create-a-namespace"},{"title":"Get a namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}","href":"/zh/api-reference/namespaces/get-a-namespace"},{"title":"Delete a namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /namespaces/{namespace}","href":"/zh/api-reference/namespaces/delete-a-namespace"}]},{"group":"文档","pages":[{"title":"Add documents","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces/{namespace}/documents","href":"/zh/api-reference/documents/add-documents"},{"title":"List documents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/documents","href":"/zh/api-reference/documents/list-documents"},{"title":"Get a document","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/documents/{id}","href":"/zh/api-reference/documents/get-a-document"},{"title":"Delete a document","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /namespaces/{namespace}/documents/{id}","href":"/zh/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":"/zh/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":"/zh/api-reference/query/query-a-namespace"},{"title":"Query every namespace","deprecated":null,"version":null,"openapi":"/openapi.yaml post /query","href":"/zh/api-reference/query/query-every-namespace"}]},{"group":"文件","pages":[{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/openapi.yaml post /namespaces/{namespace}/files","href":"/zh/api-reference/files/upload-a-file"},{"title":"Read a file","deprecated":null,"version":null,"openapi":"/openapi.yaml get /namespaces/{namespace}/files/{id}","href":"/zh/api-reference/files/read-a-file"}]},{"group":"解析","pages":[{"title":"Parse a file to Markdown","deprecated":null,"version":null,"openapi":"/openapi.yaml post /parse","href":"/zh/api-reference/parse/parse-a-file-to-markdown"},{"title":"Get a parse result","deprecated":null,"version":null,"openapi":"/openapi.yaml get /parse/{id}","href":"/zh/api-reference/parse/get-a-parse-result"}]},{"group":"数据源","pages":[{"title":"List source types","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/types","href":"/zh/api-reference/sources/list-source-types"},{"title":"Connect a source","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources","href":"/zh/api-reference/sources/connect-a-source"},{"title":"List sources","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources","href":"/zh/api-reference/sources/list-sources"},{"title":"Get a source","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/{id}","href":"/zh/api-reference/sources/get-a-source"},{"title":"Set how often a source syncs","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /sources/{id}","href":"/zh/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":"/zh/api-reference/sources/sync-a-source-now"},{"title":"Disconnect a source","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /sources/{id}","href":"/zh/api-reference/sources/disconnect-a-source"},{"title":"Get the bucket service account","description":"The Google service account a Google Cloud Storage source reads as, and the role to grant it on your bucket.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/gcs","href":"/zh/api-reference/sources/get-the-bucket-service-account"},{"title":"Preview a bucket","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/gcs/preview","href":"/zh/api-reference/sources/preview-a-bucket"},{"title":"List a source's failures","description":"A Google Cloud Storage source's objects it could not keep, whole or in part, in key order.\n\n- `code`: `unsupported_file`, `too_large`, `pages_unread`, or a failed parse's code (`type_mismatch`, `unreadable_file`, ...).\n- A failed object is read again when it changes; a passing failure is retried at the next 3 syncs, then daily.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/{id}/failures","href":"/zh/api-reference/sources/list-a-sources-failures"}]},{"group":"自定义数据源","pages":[{"title":"Push documents","deprecated":null,"version":null,"openapi":"/openapi.yaml put /sources/{id}/documents","href":"/zh/api-reference/custom-sources/push-documents"},{"title":"List a source's documents","deprecated":null,"version":null,"openapi":"/openapi.yaml get /sources/{id}/documents","href":"/zh/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":"/zh/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":"/zh/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":"/zh/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":"/zh/api-reference/custom-sources/restore-excluded-documents"},{"title":"Open a snapshot run","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/runs","href":"/zh/api-reference/custom-sources/open-a-snapshot-run"},{"title":"Import an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /sources/{id}/imports","href":"/zh/api-reference/custom-sources/import-an-upload"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/openapi.yaml get /runs/{id}","href":"/zh/api-reference/custom-sources/get-a-run"},{"title":"Complete a snapshot run","deprecated":null,"version":null,"openapi":"/openapi.yaml post /runs/{id}/complete","href":"/zh/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":"/zh/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":"/zh/api-reference/custom-sources/list-an-imports-failures"},{"title":"Start an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /uploads","href":"/zh/api-reference/custom-sources/start-an-upload"},{"title":"Get an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml get /uploads/{id}","href":"/zh/api-reference/custom-sources/get-an-upload"},{"title":"Send a part","deprecated":null,"version":null,"openapi":"/openapi.yaml put /uploads/{id}/parts/{n}","href":"/zh/api-reference/custom-sources/send-a-part"},{"title":"Complete an upload","deprecated":null,"version":null,"openapi":"/openapi.yaml post /uploads/{id}/complete","href":"/zh/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":"/zh/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":"/zh/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":"/zh/api-reference/models/rerank-documents-cohere-v2-compatible"},{"title":"List models (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/models","href":"/zh/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":"/zh/api-reference/models/retrieve-a-model-openai-compatible"},{"title":"Embed texts","deprecated":null,"version":null,"openapi":"/openapi.yaml post /embed","href":"/zh/api-reference/models/embed-texts"},{"title":"Rerank documents","deprecated":null,"version":null,"openapi":"/openapi.yaml post /rerank","href":"/zh/api-reference/models/rerank-documents"}]},{"group":"用户","pages":[{"title":"Delete a user's data","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users/{user}","href":"/zh/api-reference/users/delete-a-users-data"},{"title":"Delete every user under a prefix","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /users","href":"/zh/api-reference/users/delete-every-user-under-a-prefix"}]},{"group":"事件","pages":[{"title":"List events","deprecated":null,"version":null,"openapi":"/openapi.yaml get /events","href":"/zh/api-reference/events/list-events"}]},{"group":"组织","pages":[{"title":"List organizations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /organizations","href":"/zh/api-reference/organizations/list-organizations"}]},{"group":"健康检查","pages":[{"title":"Deep health check","deprecated":null,"version":null,"openapi":"/openapi.yaml get /health/deep","href":"/zh/api-reference/health/deep-health-check"}]}]}]}]},"title":"Preview a bucket - 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"]}