API Reference

The Tenzro Cloud API is a RESTful API that provides access to all platform services. All endpoints are available at https://api.cloud.tenzro.com.

Base URL

https://api.cloud.tenzro.com

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Request Format

All requests should include Content-Type: application/json for POST/PUT/PATCH requests. Query parameters are used for filtering and pagination.

Response Format

All responses are JSON. Successful responses include:

{
  "success": true,
  "data": { ... }
}

Error responses include:

{
  "error": "Error Type",
  "message": "Human readable error message",
  "details": { ... }
}

Available Endpoints

Health

Vec (Vector Database)

Kev (Key-Value Store)

Data (PostgreSQL)

AI Inference

Agents

Workflows

MCP Servers

File Storage

Security

Enclaves

Hub

Entities (Organizations)

SDK Usage

Use the official SDKs for easy integration:

TypeScript/JavaScript

npm install @tenzro/cloud

import { Tenzro } from '@tenzro/cloud';

const tenzro = new Tenzro({
  apiKey: process.env.TENZRO_API_KEY,
});

// Use any service
const databases = await tenzro.vec.list();
const result = await tenzro.ai.infer({
  model: 'gemini-2.5-flash',
  messages: [{ role: 'user', content: 'Hello!' }],
});

Python

pip install tenzro-cloud

from tenzro_cloud import Tenzro

tenzro = Tenzro(
    api_key=os.environ.get("TENZRO_API_KEY")
)

# Use any service
databases = tenzro.vec.list()
result = tenzro.ai.infer(
    model="gemini-2.5-flash",
    messages=[{"role": "user", "content": "Hello!"}]
)

Rate Limits

API rate limits are per-key and per-service. Default limits are:

• Starter: 100 requests/min, 1,000 AI tokens/day
• Professional: 1,000 requests/min, 100,000 AI tokens/day
• Enterprise: Custom limits

Error Handling

Common HTTP status codes: