API Reference

https://api.veclabs.xyz/api/v1

POST /collections

{
  "name": "agent-memory",
  "dimensions": 1536,
  "metric": "cosine"
}

{
  "collection": {
    "id": "uuid",
    "name": "agent-memory",
    "dimensions": 1536,
    "metric": "cosine",
    "vector_count": 0,
    "created_at": "2026-04-30T00:00:00Z"
  }
}

GET /collections

DELETE /collections/{name}

POST /collections/{name}/upsert

{
  "records": [
    {
      "id": "mem_001",
      "values": [0.1, 0.2, ...],
      "metadata": { "text": "User prefers dark mode" }
    }
  ]
}

{
  "upsertedCount": 1,
  "merkleRoot": "90d483c77c4e...",
  "solanaProgram": "8xjQ2XrdhR4JkGAdTEB7i34DBkbrLRkcgchKjN1Vn5nP",
  "solanaTx": "42sxn4j...",
  "solanaExplorerUrl": "https://explorer.solana.com/tx/42sxn4j...?cluster=devnet"
}

POST /collections/{name}/query

{
  "vector": [0.1, 0.2, ...],
  "topK": 10,
  "includeValues": false,
  "filter": {}
}

{
  "matches": [
    {
      "id": "mem_001",
      "score": 0.97,
      "metadata": { "text": "User prefers dark mode" }
    }
  ]
}

POST /collections/{name}/delete

{
  "ids": ["mem_001", "mem_002"]
}

POST /collections/{name}/fetch

{
  "ids": ["mem_001"]
}

GET /collections/{name}/verify

{
  "verified": true,
  "onChainRoot": "90d483c...",
  "computedRoot": "90d483c...",
  "match": true,
  "vectorCount": 42,
  "solanaExplorerUrl": "https://explorer.solana.com/address/...?cluster=devnet"
}

GET /usage

GET /keys

POST /keys

{ "name": "Production" }

DELETE /keys/{id}