API Overview


All API calls require authenticating with your API token. You can create and expire tokens in your dashboard.

The HTTP API expects the API token to be formatted as a standard Bearer token and passed in the Authorization header.

For example, if your token is abc, the Authorization header value is simply Bearer abc.


The API uses JSON encoding for both request and response payloads.


JSON encoded vector payloads can be quite large. To save on networking costs, we recommend compressing your requests, and accepting compressed responses. The API supports standard HTTP compression headers:

Compress your request payload and include Content-Encoding: gzip to enable compressed requests.

Include Accept-Encoding: gzip to enable compressed responses.

Error responses

If an error occurs for your request, all endpoints will return a JSON payload in the format:


  "status": "error",
  "error": "an error message"
Email us
© 2024 turbopuffer Inc.
Privacy PolicyTerms of service
SOC2 Type 1 certified