VectorStores

A VectorStore is the serving connection used to write and query rows. The gateway exposes read-only routes that include Secret reference names and keys, never Secret contents. All routes require a key with read scope.

Create and edit connections through the VectorStore CRD or the dashboard’s apply forms.

List VectorStores

curl -H "Authorization: Bearer $LAYER_API_KEY" \
  "$LAYER_BASE_URL/v2/vectorstores"

{
  "vectorstores": [
    {
      "name": "prod-turbopuffer",
      "kind": "turbopuffer",
      "default": true,
      "endpoint": {
        "url": "https://aws-us-east-1.turbopuffer.com",
        "region": "aws-us-east-1"
      },
      "turbopuffer": {
        "orgId": "org_123"
      },
      "credential": {
        "secretRef": {
          "name": "layer-turbopuffer",
          "key": "turbopuffer-api-key"
        }
      },
      "inboundAuth": {
        "mode": "deriveFromStore"
      },
      "status": {
        "reachable": true,
        "observedGeneration": 7,
        "conditions": []
      },
      "turbopufferUrl": "https://turbopuffer.com/organizations/org_123"
    }
  ]
}

GET /v2/vectorstores/{name} returns one object in the same shape. turbopufferUrl is omitted when spec.turbopuffer.orgId is not set.