This endpoint creates a vector store using the specified engine and configuration.
Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future.
Authentication:
For SGP Knowledge Base, SGP credentials are required
Returns:
Created vector store entity with ID, name, engine, and creation timestamp
Example Request:
{ "engine": "sgp_knowledge_base", "name": "My Knowledge Base", "embedding_model": "openai/text-embedding-3-large",}
Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.
Engine-specific external identifier used when calling the upstream API. For SGP Knowledge Base this equals the SGP KB UUID (same as id). For SGP Vector Store this is '<account_id>::'.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Scale AI","colors":{"primary":"#3f2e7b","light":"#ca62ff","dark":"#3f2e7b"},"logo":{"light":"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/light.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=46027042c16b373ac463148db5ad1d6b","dark":"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/dark.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=02733f39d684d796ec742853eabf0de5"},"favicon":"https://mintcdn.com/scalegp/1vQnbXFkjbQbcgd1/favicon.png?fit=max\u0026auto=format\u0026n=1vQnbXFkjbQbcgd1\u0026q=85\u0026s=f52c84ba46a7cca58551673616dabe9c","background":{"decoration":"windows"},"navbar":{"links":[],"primary":{"type":"button","label":"Platform","href":"https://app.sgp.scale.com/"}},"footer":{"socials":{"x":"https://x.com/scale_ai","facebook":"https://www.facebook.com/scaleapi","linkedin":"https://www.linkedin.com/company/scaleai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scalegp","hasAudioNarration":false,"actualSubdomain":"scalegp","customDomains":["docs.gp.scale.com"],"gitSource":{"type":"github","owner":"scaleapi","repo":"sgp-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6abeb90f3a8b8379c1eaf648","collectionId":"437f531c-55bf-41b5-8f5d-4e63781df61e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6abeb90f3a8b8379c1eaf648"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6abeb90f3a8b8379c1eaf648","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":235},{"language":"default","tag":"AgentOps API","count":141},{"language":"default","tag":"Guides","count":131},{"language":"default","tag":"Agentex API","count":94},{"language":"default","tag":"Evaluations","count":72},{"language":"default","tag":"Dex API","count":48},{"language":"default","tag":"Agents","count":41},{"language":"default","tag":"Evaluation Datasets","count":34},{"language":"default","tag":"Models","count":32},{"language":"default","tag":"Knowledge Bases","count":31}]},"assistantConfig":{},"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":false},"customCss":[{"filePath":"styles.css","content":"@font-face{font-family:'Aeonik';src:url(https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2);font-weight:400;font-style:normal;font-display:swap}h1,h2,h3{font-family:'aeonik';letter-spacing:normal!important}"}],"page":{"pagePath":"reference/dex/vector-stores/create-a-new-vector-store","slug":"/reference/dex/vector-stores/create-a-new-vector-store","pageMetadata":{"title":"Create a new vector store","description":"Create a new vector store for a project.\n\n This endpoint creates a vector store using the specified engine and configuration.\n Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future.\n\n **Authentication:**\n - For SGP Knowledge Base, SGP credentials are required\n\n **Returns:**\n - Created vector store entity with ID, name, engine, and creation timestamp\n\n **Example Request:**\n ```json\n {\n \"engine\": \"sgp_knowledge_base\",\n \"name\": \"My Knowledge Base\",\n \"embedding_model\": \"openai/text-embedding-3-large\",\n }\n ```\n\n **Example Response:**\n ```json\n {\n \"id\": \"vs_123456789\",\n \"project_id\": \"proj_987654321\",\n \"name\": \"My Knowledge Base\",\n \"engine\": \"sgp_knowledge_base\",\n \"created_at\": \"2024-01-15T10:30:00Z\"\n }\n ```","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/vector-stores","href":"/reference/dex/vector-stores/create-a-new-vector-store","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 pre: \"pre\",\n span: \"span\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n }, {CodeBlock} = _components;\n if (!CodeBlock) _missingMdxReference(\"CodeBlock\", true);\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create a new vector store for a project.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"This endpoint creates a vector store using the specified engine and configuration.\\nCurrently supports SGP Knowledge Base engine, but we plan to support more engines in the future.\"\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Authentication:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"For SGP Knowledge Base, SGP credentials are required\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Returns:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Created vector store entity with ID, name, engine, and creation timestamp\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Example Request:\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"5\",\n language: \"json\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"json\",\n children: _jsxs(_components.code, {\n language: \"json\",\n numberOfLines: \"5\",\n children: [_jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"{\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"engine\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"sgp_knowledge_base\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"name\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"My Knowledge Base\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"embedding_model\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"openai/text-embedding-3-large\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"}\"\n })\n }), \"\\n\"]\n })\n })\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Example Response:\"\n })\n }), \"\\n\", _jsx(CodeBlock, {\n numberOfLines: \"7\",\n language: \"json\",\n children: _jsx(_components.pre, {\n className: \"shiki shiki-themes github-light-default dark-plus\",\n style: {\n backgroundColor: \"#ffffff\",\n \"--shiki-dark-bg\": \"#0B0C0E\",\n color: \"#1f2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n language: \"json\",\n children: _jsxs(_components.code, {\n language: \"json\",\n numberOfLines: \"7\",\n children: [_jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"{\"\n })\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"id\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"vs_123456789\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"project_id\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"proj_987654321\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"name\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"My Knowledge Base\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"engine\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"sgp_knowledge_base\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \",\"\n })]\n }), \"\\n\", _jsxs(_components.span, {\n className: \"line\",\n children: [_jsx(_components.span, {\n style: {\n color: \"#116329\",\n \"--shiki-dark\": \"#9CDCFE\"\n },\n children: \" \\\"created_at\\\"\"\n }), _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \": \"\n }), _jsx(_components.span, {\n style: {\n color: \"#0A3069\",\n \"--shiki-dark\": \"#CE9178\"\n },\n children: \"\\\"2024-01-15T10:30:00Z\\\"\"\n })]\n }), \"\\n\", _jsx(_components.span, {\n className: \"line\",\n children: _jsx(_components.span, {\n style: {\n color: \"#1F2328\",\n \"--shiki-dark\": \"#D4D4D4\"\n },\n children: \"}\"\n })\n }), \"\\n\"]\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};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\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":"Create a new vector store","description":"Create a new vector store for a project.\n\n This endpoint creates a vector store using the specified engine and configuration.\n Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future.\n\n **Authentication:**\n - For SGP Knowledge Base, SGP credentials are required\n\n **Returns:**\n - Created vector store entity with ID, name, engine, and creation timestamp\n\n **Example Request:**\n ```json\n {\n \"engine\": \"sgp_knowledge_base\",\n \"name\": \"My Knowledge Base\",\n \"embedding_model\": \"openai/text-embedding-3-large\",\n }\n ```\n\n **Example Response:**\n ```json\n {\n \"id\": \"vs_123456789\",\n \"project_id\": \"proj_987654321\",\n \"name\": \"My Knowledge Base\",\n \"engine\": \"sgp_knowledge_base\",\n \"created_at\": \"2024-01-15T10:30:00Z\"\n }\n ```","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/vector-stores","href":"/reference/dex/vector-stores/create-a-new-vector-store","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Vector Stores"],"summary":"Create a new vector store","description":"Create a new vector store for a project.\n\n This endpoint creates a vector store using the specified engine and configuration.\n Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future.\n\n **Authentication:**\n - For SGP Knowledge Base, SGP credentials are required\n\n **Returns:**\n - Created vector store entity with ID, name, engine, and creation timestamp\n\n **Example Request:**\n ```json\n {\n \"engine\": \"sgp_knowledge_base\",\n \"name\": \"My Knowledge Base\",\n \"embedding_model\": \"openai/text-embedding-3-large\",\n }\n ```\n\n **Example Response:**\n ```json\n {\n \"id\": \"vs_123456789\",\n \"project_id\": \"proj_987654321\",\n \"name\": \"My Knowledge Base\",\n \"engine\": \"sgp_knowledge_base\",\n \"created_at\": \"2024-01-15T10:30:00Z\"\n }\n ```","operationId":"create_vector_store_v1_projects__project_id__vector_stores_post","parameters":["16e63489-0432-4f72-a51f-82b70a62e9fb"],"requestBody":"371033c3-5447-4a66-b05a-b5593c8dc8c2","responses":{"201":"21004989-9706-45a1-911b-e901c710cd9f","400":"4baa1299-a09e-4867-b434-2c4e718b477b","404":"7673f280-078a-456b-bee6-047f25c5f87e","422":"29bca87d-681b-4183-b13b-db14c3bfe3f3","500":"cbd45e9d-ffab-4002-9c8e-fb32c120228e"},"method":"post","type":"path","servers":[],"security":["3d5b6088-a4a5-4a82-8450-48a5ac5593af"],"path":"/v1/projects/{project_id}/vector-stores","baseUrlOptions":[],"title":"Create a new vector store","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"16e63489-0432-4f72-a51f-82b70a62e9fb":{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"SGPVectorStoreCreateRequestBase","required":["name","embedding_model"],"properties":{"name":{"type":"string","title":"Name","description":"Name of the vector store","isRequired":true,"uniqueKey":"oneOf.0.name","typeLabel":"string"},"embedding_model":{"oneOf":[{"type":"string","title":"Embedding Model","description":"Embedding model to use for SGP Vector Store. e.g. openai/text-embedding-3-large","enum":["sentence-transformers/all-MiniLM-L12-v2","sentence-transformers/all-mpnet-base-v2","sentence-transformers/multi-qa-distilbert-cos-v1","sentence-transformers/paraphrase-multilingual-mpnet-base-v2","openai/text-embedding-ada-002","openai/text-embedding-3-small","openai/text-embedding-3-large","embed-english-v3.0","embed-english-light-v3.0","embed-multilingual-v3.0","gemini/text-embedding-005","gemini/text-multilingual-embedding-002","gemini/gemini-embedding-001"],"isRequired":true,"uniqueKey":"oneOf.0.embedding_model.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","title":"Embedding Model","description":"Embedding model to use for SGP Vector Store. e.g. openai/text-embedding-3-large","isRequired":true,"uniqueKey":"oneOf.0.embedding_model.oneOf.1","typeLabel":"string"}],"isRequired":true,"uniqueKey":"oneOf.0.embedding_model","typeLabel":"enum\u003cstring> | string"},"engine":{"type":"string","const":"sgp_vector_store","title":"Engine","default":"sgp_vector_store","uniqueKey":"oneOf.0.engine","typeLabel":"string"},"vector_store_metadata_schema":{"oneOf":[{"type":"object","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","additionalProperties":{"type":"string","enum":["string","int","double","boolean"],"uniqueKey":"oneOf.0.vector_store_metadata_schema.oneOf.0.additionalProperties","typeLabel":"enum\u003cstring>"},"uniqueKey":"oneOf.0.vector_store_metadata_schema.oneOf.0","typeLabel":"Vector Store Metadata Schema · object"},{"type":"null","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","uniqueKey":"oneOf.0.vector_store_metadata_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.vector_store_metadata_schema","typeLabel":"Vector Store Metadata Schema · object | null"},"embedding_type":{"type":"string","const":"base","title":"Embedding Type","description":"Type of embedding configuration for standard models","default":"base","uniqueKey":"oneOf.0.embedding_type","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"SGPVectorStoreCreateRequestBase · object"},{"type":"object","title":"SGPVectorStoreCreateRequestModelsApi","required":["name","model_deployment_id"],"properties":{"name":{"type":"string","title":"Name","description":"Name of the vector store","isRequired":true,"uniqueKey":"oneOf.1.name","typeLabel":"string"},"model_deployment_id":{"type":"string","title":"Model Deployment Id","description":"Model deployment ID for 'models_api' type from Models API V4","isRequired":true,"uniqueKey":"oneOf.1.model_deployment_id","typeLabel":"string"},"engine":{"type":"string","const":"sgp_vector_store","title":"Engine","default":"sgp_vector_store","uniqueKey":"oneOf.1.engine","typeLabel":"string"},"vector_store_metadata_schema":{"oneOf":[{"type":"object","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","additionalProperties":{"type":"string","enum":["string","int","double","boolean"],"uniqueKey":"oneOf.1.vector_store_metadata_schema.oneOf.0.additionalProperties","typeLabel":"enum\u003cstring>"},"uniqueKey":"oneOf.1.vector_store_metadata_schema.oneOf.0","typeLabel":"Vector Store Metadata Schema · object"},{"type":"null","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","uniqueKey":"oneOf.1.vector_store_metadata_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.vector_store_metadata_schema","typeLabel":"Vector Store Metadata Schema · object | null"},"embedding_type":{"type":"string","const":"models_api","title":"Embedding Type","description":"Type of embedding configuration for custom deployed models","default":"models_api","uniqueKey":"oneOf.1.embedding_type","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"SGPVectorStoreCreateRequestModelsApi · object"},{"type":"object","title":"SGPKnowledgeBaseCreateRequestBase","required":["name","embedding_model"],"properties":{"name":{"type":"string","title":"Name","description":"Name of the vector store","isRequired":true,"uniqueKey":"oneOf.2.name","typeLabel":"string"},"embedding_model":{"type":"string","title":"Embedding Model","description":"Embedding model to use for 'base' type. e.g. openai/text-embedding-3-large","isRequired":true,"uniqueKey":"oneOf.2.embedding_model","typeLabel":"string"},"engine":{"type":"string","const":"sgp_knowledge_base","title":"Engine","default":"sgp_knowledge_base","uniqueKey":"oneOf.2.engine","typeLabel":"string"},"vector_store_metadata_schema":{"oneOf":[{"type":"object","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","additionalProperties":{"type":"string","enum":["string","int","double","boolean"],"uniqueKey":"oneOf.2.vector_store_metadata_schema.oneOf.0.additionalProperties","typeLabel":"enum\u003cstring>"},"uniqueKey":"oneOf.2.vector_store_metadata_schema.oneOf.0","typeLabel":"Vector Store Metadata Schema · object"},{"type":"null","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","uniqueKey":"oneOf.2.vector_store_metadata_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.2.vector_store_metadata_schema","typeLabel":"Vector Store Metadata Schema · object | null"},"embedding_type":{"type":"string","const":"base","title":"Embedding Type","description":"Type of embedding configuration for standard models","default":"base","uniqueKey":"oneOf.2.embedding_type","typeLabel":"string"}},"uniqueKey":"oneOf.2","typeLabel":"SGPKnowledgeBaseCreateRequestBase · object"},{"type":"object","title":"SGPKnowledgeBaseCreateRequestModelsApi","required":["name","model_deployment_id"],"properties":{"name":{"type":"string","title":"Name","description":"Name of the vector store","isRequired":true,"uniqueKey":"oneOf.3.name","typeLabel":"string"},"model_deployment_id":{"type":"string","title":"Model Deployment Id","description":"Model deployment ID for 'models_api' type from Models API V4","isRequired":true,"uniqueKey":"oneOf.3.model_deployment_id","typeLabel":"string"},"engine":{"type":"string","const":"sgp_knowledge_base","title":"Engine","default":"sgp_knowledge_base","uniqueKey":"oneOf.3.engine","typeLabel":"string"},"vector_store_metadata_schema":{"oneOf":[{"type":"object","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","additionalProperties":{"type":"string","enum":["string","int","double","boolean"],"uniqueKey":"oneOf.3.vector_store_metadata_schema.oneOf.0.additionalProperties","typeLabel":"enum\u003cstring>"},"uniqueKey":"oneOf.3.vector_store_metadata_schema.oneOf.0","typeLabel":"Vector Store Metadata Schema · object"},{"type":"null","title":"Vector Store Metadata Schema","description":"Schema of the vector store metadata. You can set metadata for parsed documents and they will be indexed as extra metadata in the vector store to filter on when searching.","uniqueKey":"oneOf.3.vector_store_metadata_schema.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.3.vector_store_metadata_schema","typeLabel":"Vector Store Metadata Schema · object | null"},"embedding_type":{"type":"string","const":"models_api","title":"Embedding Type","description":"Type of embedding configuration for custom deployed models","default":"models_api","uniqueKey":"oneOf.3.embedding_type","typeLabel":"string"}},"uniqueKey":"oneOf.3","typeLabel":"SGPKnowledgeBaseCreateRequestModelsApi · object"}],"uniqueKey":"","typeLabel":"SGPVectorStoreCreateRequestBase · object | SGPVectorStoreCreateRequestModelsApi · object | SGPKnowledgeBaseCreateRequestBase · object | SGPKnowledgeBaseCreateRequestModelsApi · object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","engine":"sgp_vector_store","vector_store_metadata_schema":{},"embedding_type":"base"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"21004989-9706-45a1-911b-e901c710cd9f":{"description":"Vector store created successfully","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Id","description":"ID of the entity","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"project_id":{"type":"string","title":"Project Id","description":"ID of the project","isRequired":true,"uniqueKey":"project_id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"Name of the vector store","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"engine":{"type":"string","enum":["sgp_knowledge_base","sgp_vector_store"],"title":"VectorStoreEngines","description":"Engine used for vector store","isRequired":true,"uniqueKey":"engine","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the vector store was created","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"external_id":{"oneOf":[{"type":"string","title":"External Id","description":"Engine-specific external identifier used when calling the upstream API. For SGP Knowledge Base this equals the SGP KB UUID (same as id). For SGP Vector Store this is '\u003caccount_id>::\u003cname>'.","uniqueKey":"external_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"External Id","description":"Engine-specific external identifier used when calling the upstream API. For SGP Knowledge Base this equals the SGP KB UUID (same as id). For SGP Vector Store this is '\u003caccount_id>::\u003cname>'.","uniqueKey":"external_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"external_id","typeLabel":"string | null"}},"additionalProperties":true,"type":"object","required":["id","project_id","name","engine","created_at"],"title":"VectorStoreEntity","uniqueKey":"","typeLabel":"VectorStoreEntity · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","project_id":"\u003cstring>","name":"\u003cstring>","engine":"sgp_knowledge_base","created_at":"2023-11-07T05:31:56Z","external_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4baa1299-a09e-4867-b434-2c4e718b477b":{"description":"Bad request - Missing required fields","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7673f280-078a-456b-bee6-047f25c5f87e":{"description":"Project not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"29bca87d-681b-4183-b13b-db14c3bfe3f3":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"cbd45e9d-ffab-4002-9c8e-fb32c120228e":{"description":"Internal server error - Failed to create vector store in third-party engine","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"3d5b6088-a4a5-4a82-8450-48a5ac5593af":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication","scopes":[]},"AccountId":{"type":"apiKey","in":"header","name":"x-selected-account-id","description":"Selected Account ID","scopes":[]}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"x-api-key"},{"scheme":{"type":"apiKey","in":"header","name":"x-selected-account-id","description":"Selected Account ID","scopes":[]},"schema":{"title":"x-selected-account-id","type":"string","description":"Selected Account ID","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AccountId","name":"x-selected-account-id"}],"title":"ApiKey \u0026 AccountId"}]},"originalFileLocation":"https://dex.sgp.scale.com/openapi.json"},"subdomain":"scalegp","siteName":"Scale AI","title":"Create a new vector store - Scale AI","navMaps":{"firstHrefInVersion":{"V5":{"href":"/reference/dex/vector-stores/create-a-new-vector-store","matchLevel":0},"V4 (legacy)":{"href":"/home","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-09-28T19:56:23.236Z","originalFileLocation":"reference/dex/vector-stores/create-a-new-vector-store.mdx"},"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=\"Create a new vector store for a project. This endpoint creates a vector store using the specified engine and configuration. Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future. Authentication: - For SGP Knowledge Base, SGP credentials are required Returns: - Created vector store entity with ID, name, engine, and creation timestamp Example Request: json { \u0026quot;engine\u0026quot;: \u0026quot;sgp_knowledge_base\u0026quot;, \u0026quot;name\u0026quot;: \u0026quot;My Knowledge Base\u0026quot;, \u0026quot;embedding_model\u0026quot;: \u0026quot;openai/text-embedding-3-large\u0026quot;, } Example Response: json { \u0026quot;id\u0026quot;: \u0026quot;vs_123456789\u0026quot;, \u0026quot;project_id\u0026quot;: \u0026quot;proj_987654321\u0026quot;, \u0026quot;name\u0026quot;: \u0026quot;My Knowledge Base\u0026quot;, \u0026quot;engine\u0026quot;: \u0026quot;sgp_knowledge_base\u0026quot;, \u0026quot;created_at\u0026quot;: \u0026quot;2024-01-15T10:30:00Z\u0026quot; }\">\u003cmeta data-mint-head name=\"application-name\" content=\"Scale AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_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/scalegp/UksUEh3sxckFW0X-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scalegp/UksUEh3sxckFW0X-/_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/scalegp/UksUEh3sxckFW0X-/_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/scalegp/UksUEh3sxckFW0X-/_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/scalegp/UksUEh3sxckFW0X-/_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/scalegp/UksUEh3sxckFW0X-/_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/scalegp/UksUEh3sxckFW0X-/_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/scalegp/UksUEh3sxckFW0X-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new vector store - Scale AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new vector store for a project. This endpoint creates a vector store using the specified engine and configuration. Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future. Authentication: - For SGP Knowledge Base, SGP credentials are required Returns: - Created vector store entity with ID, name, engine, and creation timestamp Example Request: json { \u0026quot;engine\u0026quot;: \u0026quot;sgp_knowledge_base\u0026quot;, \u0026quot;name\u0026quot;: \u0026quot;My Knowledge Base\u0026quot;, \u0026quot;embedding_model\u0026quot;: \u0026quot;openai/text-embedding-3-large\u0026quot;, } Example Response: json { \u0026quot;id\u0026quot;: \u0026quot;vs_123456789\u0026quot;, \u0026quot;project_id\u0026quot;: \u0026quot;proj_987654321\u0026quot;, \u0026quot;name\u0026quot;: \u0026quot;My Knowledge Base\u0026quot;, \u0026quot;engine\u0026quot;: \u0026quot;sgp_knowledge_base\u0026quot;, \u0026quot;created_at\u0026quot;: \u0026quot;2024-01-15T10:30:00Z\u0026quot; }\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Scale AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scalegp.mintlify.app/_mintlify/api/og/v2?division=Vector+Stores\u0026amp;title=Create+a+new+vector+store\u0026amp;description=Create+a+new+vector+store+for+a+project.%0A%0A++++This+endpoint+creates+a+vector+store+using+the+specified+engine+and+configuration.%0A++++Currently+supports+SGP+Know\u0026amp;theme=b7e87dd2f9a2a23155199f59\u0026amp;signature=5ae1203ee59f7b7e8443cbc3543522636d190c8f842cbf6afe04d9658e9ee540\">\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=\"Create a new vector store - Scale AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new vector store for a project. This endpoint creates a vector store using the specified engine and configuration. Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future. Authentication: - For SGP Knowledge Base, SGP credentials are required Returns: - Created vector store entity with ID, name, engine, and creation timestamp Example Request: json { \u0026quot;engine\u0026quot;: \u0026quot;sgp_knowledge_base\u0026quot;, \u0026quot;name\u0026quot;: \u0026quot;My Knowledge Base\u0026quot;, \u0026quot;embedding_model\u0026quot;: \u0026quot;openai/text-embedding-3-large\u0026quot;, } Example Response: json { \u0026quot;id\u0026quot;: \u0026quot;vs_123456789\u0026quot;, \u0026quot;project_id\u0026quot;: \u0026quot;proj_987654321\u0026quot;, \u0026quot;name\u0026quot;: \u0026quot;My Knowledge Base\u0026quot;, \u0026quot;engine\u0026quot;: \u0026quot;sgp_knowledge_base\u0026quot;, \u0026quot;created_at\u0026quot;: \u0026quot;2024-01-15T10:30:00Z\u0026quot; }\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scalegp.mintlify.app/_mintlify/api/og/v2?division=Vector+Stores\u0026amp;title=Create+a+new+vector+store\u0026amp;description=Create+a+new+vector+store+for+a+project.%0A%0A++++This+endpoint+creates+a+vector+store+using+the+specified+engine+and+configuration.%0A++++Currently+supports+SGP+Know\u0026amp;theme=b7e87dd2f9a2a23155199f59\u0026amp;signature=5ae1203ee59f7b7e8443cbc3543522636d190c8f842cbf6afe04d9658e9ee540\">\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/scalegp/UksUEh3sxckFW0X-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Scale AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3f2e7b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/dex/vector-stores/create-a-new-vector-store.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gp.scale.com/#organization\",\"name\":\"Scale AI\",\"url\":\"https://docs.gp.scale.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scalegp/TBmst1qiYXwYqUB5/logo/light.png?fit=max\u0026auto=format\u0026n=TBmst1qiYXwYqUB5\u0026q=85\u0026s=46027042c16b373ac463148db5ad1d6b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gp.scale.com#website\",\"name\":\"Scale AI\",\"url\":\"https://docs.gp.scale.com\",\"publisher\":{\"@id\":\"https://docs.gp.scale.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store#webpage\",\"url\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store\",\"name\":\"Create a new vector store\",\"description\":\"Create a new vector store for a project. This endpoint creates a vector store using the specified engine and configuration. Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future. Authentication: - For SGP Knowledge Base, SGP credentials are required Returns: - Created vector store entity with ID, name, engine, and creation timestamp Example Request: json { \\\"engine\\\": \\\"sgp_knowledge_base\\\", \\\"name\\\": \\\"My Knowledge Base\\\", \\\"embedding_model\\\": \\\"openai/text-embedding-3-large\\\", } Example Response: json { \\\"id\\\": \\\"vs_123456789\\\", \\\"project_id\\\": \\\"proj_987654321\\\", \\\"name\\\": \\\"My Knowledge Base\\\", \\\"engine\\\": \\\"sgp_knowledge_base\\\", \\\"created_at\\\": \\\"2024-01-15T10:30:00Z\\\" }\",\"dateModified\":\"2026-09-28T19:56:23.236Z\",\"isPartOf\":{\"@id\":\"https://docs.gp.scale.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Vector Stores\",\"item\":\"https://docs.gp.scale.com/reference/dex/vector-stores/list-vector-stores\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a new vector store\",\"item\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store#apireference\",\"headline\":\"Create a new vector store\",\"name\":\"Create a new vector store\",\"description\":\"Create a new vector store for a project. This endpoint creates a vector store using the specified engine and configuration. Currently supports SGP Knowledge Base engine, but we plan to support more engines in the future. Authentication: - For SGP Knowledge Base, SGP credentials are required Returns: - Created vector store entity with ID, name, engine, and creation timestamp Example Request: json { \\\"engine\\\": \\\"sgp_knowledge_base\\\", \\\"name\\\": \\\"My Knowledge Base\\\", \\\"embedding_model\\\": \\\"openai/text-embedding-3-large\\\", } Example Response: json { \\\"id\\\": \\\"vs_123456789\\\", \\\"project_id\\\": \\\"proj_987654321\\\", \\\"name\\\": \\\"My Knowledge Base\\\", \\\"engine\\\": \\\"sgp_knowledge_base\\\", \\\"created_at\\\": \\\"2024-01-15T10:30:00Z\\\" }\",\"url\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gp.scale.com/reference/dex/vector-stores/create-a-new-vector-store#webpage\"},\"dateModified\":\"2026-09-28T19:56:23.236Z\",\"publisher\":{\"@id\":\"https://docs.gp.scale.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gp.scale.com#website\"}}]}\u003c/script>","siteName":"Scale AI","nav":{"global":null,"versions":[{"version":"V5","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/v5/overview"}]},{"tab":"AgentOps API","pages":[{"title":"AgentOps API","href":"/reference/v5/inference/run-inference-with-free-form-payload"}]},{"tab":"AgentOps SDK","href":"https://scaleapi.github.io/sgp-sdk-docs/api/python/"},{"tab":"Agentex API","pages":[{"title":"Agentex API","href":"/reference/agentex/agents/get-agent-by-id"}]},{"tab":"Agentex SDK","href":"https://scaleapi.github.io/agentex-sdk-docs/api/python/"},{"tab":"Capabilities","pages":[{"title":"Capabilities","href":"/docs/capabilities/overview"}]},{"tab":"Dex API","groups":[{"group":"Projects","pages":[{"title":"List Projects","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects","href":"/reference/dex/projects/list-projects"},{"title":"Create Project","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects","href":"/reference/dex/projects/create-project"},{"title":"Get Project","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}","href":"/reference/dex/projects/get-project"},{"title":"Update Project","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json put /v1/projects/{project_id}","href":"/reference/dex/projects/update-project"}]},{"group":"Files","pages":[{"title":"List Files","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/files","href":"/reference/dex/files/list-files"},{"title":"Upload File","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/files","href":"/reference/dex/files/upload-file"},{"title":"Get By Id","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/files/{file_id}","href":"/reference/dex/files/get-by-id"},{"title":"Delete File","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json delete /v1/projects/{project_id}/files/{file_id}","href":"/reference/dex/files/delete-file"},{"title":"Get File Download Url","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/files/{file_id}/download-url","href":"/reference/dex/files/get-file-download-url"},{"title":"Stream File Content","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/files/{file_id}/stream","href":"/reference/dex/files/stream-file-content"}]},{"group":"Parse","pages":[{"title":"Create Parse Job","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/parse","href":"/reference/dex/parse/create-parse-job"},{"title":"Create Batch Parse Job","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/parse/batch","href":"/reference/dex/parse/create-batch-parse-job"},{"title":"List Parse Results","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/parse/results","href":"/reference/dex/parse/list-parse-results"},{"title":"Get Parse Result","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/parse/{parse_result_id}/result","href":"/reference/dex/parse/get-parse-result"},{"title":"Upload Parse Result","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/parse/upload-result","href":"/reference/dex/parse/upload-parse-result"},{"title":"Create Chunk Job","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/parse/{parse_result_id}/rechunk","href":"/reference/dex/parse/create-chunk-job"}]},{"group":"Vector Stores","pages":[{"title":"List vector stores","description":"Retrieve a paginated list of vector stores for a project.\n\n This endpoint returns all vector stores associated with the specified project,\n with optional filtering by name and engine type.\n\n **Filtering:**\n - `name`: Filter vector stores by exact name match\n - `engine`: Filter by vector store engine type (e.g., sgp_knowledge_base)\n - `ids`: Filter by vector store IDs (list)\n - `created_at_start`: Filter by creation time (start)\n - `created_at_end`: Filter by creation time (end)\n - `project_id`: Filter by project ID (if not provided in path)\n\n **Sorting:**\n - `sort_by`: Field to sort by (id, created_at, engine, project_id)\n - `sort_order`: Sort order (asc or desc)\n\n **Token-based Pagination:**\n - New syntax (recommended): Use `page_size`, `continuation_token`, `sort_by`, `sort_order` query parameters\n - Legacy syntax (deprecated): Use `size` and `continuation_token` query parameters\n - If no pagination parameters are provided, returns a plain list\n - Use the `next_token` from the response to fetch subsequent pages\n - When `next_token` is `null`, you have reached the last page\n\n **Returns:**\n - Paginated list of vector store entities\n - Total count of matching vector stores\n - `next_token` for pagination (null if no more pages)\n\n **Example Response:**\n ```json\n {\n \"items\": [\n {\n \"id\": \"vs_123456789\",\n \"project_id\": \"proj_987654321\",\n \"name\": \"My Knowledge Base\",\n \"engine\": \"sgp_knowledge_base\",\n \"created_at\": \"2024-01-15T10:30:00Z\"\n }\n ],\n \"total_count\": 1,\n \"next_token\": \"eyJpZCI6InZlY3Rvcl9zdG9yZV8xMjM0NTY3ODkwYWJjZGVmIn0=\"\n }\n ```","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/vector-stores","href":"/reference/dex/vector-stores/list-vector-stores"},{"title":"Create a new vector store","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/vector-stores","href":"/reference/dex/vector-stores/create-a-new-vector-store"},{"title":"Get vector store details","description":"Retrieve detailed information about a specific vector store.\n\n This endpoint returns the complete metadata for a vector store including:\n - Vector store ID and name\n - Associated project ID\n - Engine type and configuration\n - Creation timestamp\n\n **Returns:**\n - Complete vector store entity with all metadata\n\n **Example Response:**\n ```json\n {\n \"id\": \"vs_123456789\",\n \"project_id\": \"proj_987654321\",\n \"name\": \"My Knowledge Base\",\n \"engine\": \"sgp_knowledge_base\",\n \"created_at\": \"2024-01-15T10:30:00Z\"\n }\n ```","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/vector-stores/{vector_store_id}","href":"/reference/dex/vector-stores/get-vector-store-details"},{"title":"Delete a vector store","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json delete /v1/projects/{project_id}/vector-stores/{vector_store_id}","href":"/reference/dex/vector-stores/delete-a-vector-store"},{"title":"List files in vector store","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/vector-stores/{vector_store_id}/files","href":"/reference/dex/vector-stores/list-files-in-vector-store"},{"title":"Add files to vector store","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/vector-stores/{vector_store_id}/files","href":"/reference/dex/vector-stores/add-files-to-vector-store"},{"title":"Remove files from vector store","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json delete /v1/projects/{project_id}/vector-stores/{vector_store_id}/files","href":"/reference/dex/vector-stores/remove-files-from-vector-store"},{"title":"Search in vector store","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/vector-stores/{vector_store_id}/search","href":"/reference/dex/vector-stores/search-in-vector-store"},{"title":"Search in vector store's file","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/vector-stores/{vector_store_id}/files/{file_id}/search","href":"/reference/dex/vector-stores/search-in-vector-stores-file"}]},{"group":"Extract","pages":[{"title":"Create Extract Job","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/extract","href":"/reference/dex/extract/create-extract-job"},{"title":"Get Extraction","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/extract/{extraction_id}/result","href":"/reference/dex/extract/get-extraction"},{"title":"List Extractions","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/extract/results","href":"/reference/dex/extract/list-extractions"}]},{"group":"Research","pages":[{"title":"Create Research Job","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/research","href":"/reference/dex/research/create-research-job"},{"title":"List Research Results","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/research/results","href":"/reference/dex/research/list-research-results"}]},{"group":"Jobs","pages":[{"title":"Get Job","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/jobs/{job_id}","href":"/reference/dex/jobs/get-job"},{"title":"List Jobs","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/jobs","href":"/reference/dex/jobs/list-jobs"},{"title":"Cancel Job","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/jobs/{job_id}/cancel","href":"/reference/dex/jobs/cancel-job"},{"title":"Stream Job Updates","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/jobs/{job_id}/updates","href":"/reference/dex/jobs/stream-job-updates"}]},{"group":"Indexes","pages":[{"title":"List Indexes","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/indexes","href":"/reference/dex/indexes/list-indexes"},{"title":"Create Index","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/indexes","href":"/reference/dex/indexes/create-index"},{"title":"Get Index","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/indexes/{index_id}","href":"/reference/dex/indexes/get-index"},{"title":"Delete Index","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json delete /v1/projects/{project_id}/indexes/{index_id}","href":"/reference/dex/indexes/delete-index"},{"title":"Batch Upsert Files To Index","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/indexes/{index_id}/files","href":"/reference/dex/indexes/batch-upsert-files-to-index"},{"title":"Batch Delete Files From Index","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json delete /v1/projects/{project_id}/indexes/{index_id}/files","href":"/reference/dex/indexes/batch-delete-files-from-index"},{"title":"Search Index","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/indexes/{index_id}/search","href":"/reference/dex/indexes/search-index"},{"title":"Navigate Index","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/indexes/{index_id}/navigate","href":"/reference/dex/indexes/navigate-index"}]},{"group":"Data sources","pages":[{"title":"List Project Data Sources","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/data-sources","href":"/reference/dex/data-sources/list-project-data-sources"},{"title":"Link Project Data Source","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/data-sources","href":"/reference/dex/data-sources/link-project-data-source"},{"title":"Get Project Data Source","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json get /v1/projects/{project_id}/data-sources/{data_source_id}","href":"/reference/dex/data-sources/get-project-data-source"},{"title":"Unlink Project Data Source","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json delete /v1/projects/{project_id}/data-sources/{data_source_id}","href":"/reference/dex/data-sources/unlink-project-data-source"},{"title":"Resync Data Source Deltas","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/projects/{project_id}/data-sources/{data_source_id}/resync","href":"/reference/dex/data-sources/resync-data-source-deltas"}]},{"group":"Webhooks","pages":[{"title":"Ingest Data Sources Change Event","deprecated":null,"version":null,"openapi":"https://dex.sgp.scale.com/openapi.json post /v1/webhooks/data-sources","href":"/reference/dex/webhooks/ingest-data-sources-change-event"}]}]}]},{"version":"V4 (legacy)","pages":[{"title":"V4 (legacy)","href":"/home"}]}]},"title":"Create a new vector store - Scale AI","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}