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

# List vector spaces

> The vector spaces the Corpus's routed Projection Generation carries, the served one first, each with its owner (the engine, or the ingestion plugin that declares it), model, dimensions, metric, indexed and query modalities, its role in the generation (served answers search, evaluation is indexed and compared but never served) and its coverage, the current segments that hold a vector in it. A Corpus built before a space was enabled lists only the spaces it was built with; rebuild it (rebuildCorpusProjection) to add the others.



## OpenAPI

````yaml /openapi.yaml get /v0/corpora/{corpus_id}/vector-spaces
openapi: 3.1.0
info:
  title: Quivr V2 public text foundation contract
  version: 0.0.0-draft
  description: >-
    THE-543 and THE-547 evaluation contracts; endpoint implementations are
    separate work. Matching criterion is plugin-owned and deferred. One
    configured webhook destination, immutable Matches, independent at-least-once
    Delivery and reference-only notifications. OpenAPI is authoritative for
    transport shapes. THE-640 adds text search and asynchronous Corpus
    projection rebuild initiation.
servers: []
security:
  - ApiKey: []
paths:
  /v0/corpora/{corpus_id}/vector-spaces:
    get:
      tags:
        - Corpora
      summary: List vector spaces
      description: >-
        The vector spaces the Corpus's routed Projection Generation carries, the
        served one first, each with its owner (the engine, or the ingestion
        plugin that declares it), model, dimensions, metric, indexed and query
        modalities, its role in the generation (served answers search,
        evaluation is indexed and compared but never served) and its coverage,
        the current segments that hold a vector in it. A Corpus built before a
        space was enabled lists only the spaces it was built with; rebuild it
        (rebuildCorpusProjection) to add the others.
      operationId: listVectorSpaces
      parameters:
        - name: corpus_id
          in: path
          required: true
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VectorSpaceList'
        default:
          description: >-
            Structured error; 401 unauthenticated, 403 unauthorized
            scope/action, 404 absent/inaccessible, 503 dependency unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    VectorSpaceList:
      type: object
      additionalProperties: false
      properties:
        projection_generation_id:
          type: string
          minLength: 1
        segments:
          type: integer
          minimum: 0
          description: >-
            Current segments the generation projects; a space whose coverage
            equals it holds a vector for every one.
        items:
          type: array
          items:
            $ref: '#/components/schemas/VectorSpace'
      required:
        - projection_generation_id
        - segments
        - items
    Error:
      type: object
      additionalProperties: false
      properties:
        code:
          type: string
          minLength: 1
        message:
          type: string
          minLength: 1
        retryable:
          type: boolean
        field:
          type: string
          minLength: 1
          description: >-
            JSON Pointer (RFC 6901) to the request member that caused a 422,
            when known (for example /config/url or /credential/secret/token on
            connector commands).
        resync_url:
          type: string
          format: uri-reference
      required:
        - code
        - message
        - retryable
    VectorSpace:
      type: object
      additionalProperties: false
      properties:
        vector_space_id:
          type: string
          minLength: 1
          description: >-
            The space's identity, as search hits report it. A plugin space is
            <name>@<version>.
        name:
          type: string
          minLength: 1
        version:
          type: string
        owner:
          type: object
          additionalProperties: false
          properties:
            kind:
              type: string
              enum:
                - engine
                - plugin
            plugin_id:
              type: string
              minLength: 1
            plugin_version:
              type: string
              minLength: 1
          required:
            - kind
        model:
          type: string
        dimensions:
          type: integer
          minimum: 0
        metric:
          type: string
          enum:
            - cosine
            - dot
            - l2
        indexes:
          type: array
          items:
            type: string
        query_modalities:
          type: array
          items:
            type: string
        role:
          type: string
          enum:
            - served
            - evaluation
        coverage:
          type: object
          additionalProperties: false
          properties:
            segments:
              type: integer
              minimum: 0
          required:
            - segments
      required:
        - vector_space_id
        - name
        - version
        - owner
        - model
        - dimensions
        - metric
        - indexes
        - query_modalities
        - role
        - coverage
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      description: >-
        API key, not necessarily a JWT. Server derives Organization, permitted
        actions and Corpus scope; every resource access is authorized.

````