> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synapsai.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a vector store

> Creates a knowledge base. The response `id` is the knowledge base id. The object type is `vector_store` so OpenAI clients stay compatible.



## OpenAPI

````yaml /api-reference/vector-stores.json post /v1/vector_stores
openapi: 3.1.0
info:
  title: SynapsAI Vector Stores API
  version: 1.0.0
servers:
  - url: https://api.synapsai.cloud
    description: Production server
security: []
paths:
  /v1/vector_stores:
    post:
      summary: Create a vector store
      description: >-
        Creates a knowledge base. The response `id` is the knowledge base id.
        The object type is `vector_store` so OpenAI clients stay compatible.
      operationId: createVectorStore
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateVectorStoreRequest'
      responses:
        '200':
          description: Created vector store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorStore'
components:
  schemas:
    CreateVectorStoreRequest:
      type: object
      properties:
        name:
          type: string
          description: Display name. Defaults to `vector-store`.
        description:
          type: string
    VectorStore:
      type: object
      description: OpenAI vector store object. This is a knowledge base.
      properties:
        id:
          type: string
          description: Knowledge base id.
        object:
          type: string
          enum:
            - vector_store
        created_at:
          type: integer
        name:
          type: string
        description:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - in_progress
            - completed
        file_counts:
          $ref: '#/components/schemas/VectorStoreFileCounts'
        last_active_at:
          type: integer
        metadata:
          type: object
          additionalProperties: true
        usage_bytes:
          type: integer
        expires_at:
          type: integer
          nullable: true
      required:
        - id
        - object
        - name
        - status
    VectorStoreFileCounts:
      type: object
      properties:
        in_progress:
          type: integer
        completed:
          type: integer
        failed:
          type: integer
        cancelled:
          type: integer
        total:
          type: integer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.