---
title: "Where the workspace's vectors stand (multilingual index)"
method: GET
path: "/v1/workspaces/{workspaceId}/knowledge/vectors"
tags: ["Knowledge"]
---

# Where the workspace's vectors stand (multilingual index)

`GET /v1/workspaces/{workspaceId}/knowledge/vectors`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/workspaces/{workspaceId}/knowledge/vectors`
- Auth: HTTP bearer

Owner/admin of the workspace, or an instance admin. The 768-d indexes and the multilingual 1024-d index (`KNOWLEDGE_VECTORS_V2`): what is bound and configured, whether searches prefer it (`read`), how many passages carry a vector of which model, which backfill passes finished, and which index each kind of search reads right now.

## Response `200`

Status

- object
  - `v1` object
    - `model` string
    - `dimensions` integer
    - `passages` boolean: KNOWLEDGE_VECTORS is bound
    - `notes_and_pages` boolean: VECTORIZE is bound
  - `v2` object
    - `bound` boolean
    - `model` string, nullable
    - `dimensions` integer
    - `active` boolean: Bound and its model is usable — written on every change
    - `problem` string, nullable: Why a bound index is unused
  - `read` 'v1' | 'v2'
  - `workspace` object, nullable
    - `chunks` object
      - `total` integer
      - `by_model` object: Passages per model of their v2 vector (`none` = no v2 vector)
      - `missing` integer: Passages without a vector of the configured model
    - `passes` object: Backfill passes finished (chunks, notes, artifacts) → model
    - `reading` object
      - `chunks` 'v1' | 'v2' | 'none'
      - `notes` 'v1' | 'v2' | 'none'
      - `artifacts` 'v1' | 'v2' | 'none'
    - `mixed` boolean: Vectors of more than one model

## Other responses

- `403`: Access denied

## Changes

- **2026-10-26** `22f0fad12c81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/knowledge/vectors/get.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)