Export vectors

GET /v1/vectors/:namespace

Use this endpoint to export your entire dataset at full precision.

If you want to look up vectors by ID, use the query endpoint with an id filter.

Parameters

cursor stringoptional

used to retrieve the next page of results (pass next_cursor from the response payload)

This endpoint may return 202 ACCEPTED if the data is not ready for export. In this case, retry the request after several seconds.

Vectors, ids, and attributes are returned in a column-oriented layout

Vectors are streamed from the write-ahead-log, so some batches may be small if you've inserted small batches.

Each batch is billed at the cost of 1 query.

Examples

// GET /v1/vectors/namespace-name
{
  "ids": [1, 2],
  "vectors": [[0.1, 0.1], [0.2, 0.2]],
  "attributes": {
    "key1": ["one", "two"],
    "key2": ["a", "b"]
  },
  "next_cursor": "eyJmaWxlX2lkIjoxMTMzfQ"
}

// GET /v1/vectors/namespace-name?cursor=eyJmaWxlX2lkIjoxMTMzfQ
{
  "ids": [3, 4],
  "vectors": [[0.3, 0.3], [0.4, 0.4]],
  "attributes": {
    "key1": ["three", "four"],
    "key2": ["c", "d"]
  },
  "next_cursor": null
}
Contact
Email us
© 2024 turbopuffer Inc.
Privacy PolicyTerms of service
SOC2 Type 1 certified