Skip to main content

Instant Database

Get a working ZeroDB project with API key in one request — no signup, no auth, no credit card.

Perfect for prototyping, hackathons, tutorials, and AI agents that need immediate database access.

Create Instant DB​

POST/api/v1/public/instant-db🔒

No authentication required.

curl -X POST https://api.ainative.studio/api/v1/public/instant-db
import requests

response = requests.post("https://api.ainative.studio/api/v1/public/instant-db")
db = response.json()

print(f"API Key: {db['api_key']}")
print(f"Project ID: {db['project_id']}")
print(f"Expires: {db['expires_at']}")
const response = await fetch("https://api.ainative.studio/api/v1/public/instant-db", {
  method: "POST"
});
const db = await response.json();

console.log(`API Key: ${db.api_key}`);
console.log(`Project ID: ${db.project_id}`);

Response:

{
  "api_key": "tmp_a1b2c3d4...",
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "base_url": "https://api.ainative.studio",
  "expires_at": "2026-04-25T12:00:00Z",
  "claim_token": "clm_xyz789..."
}
FieldDescription
api_keyTemporary API key (prefix tmp_)
project_idYour project UUID
base_urlAPI base URL for all ZeroDB operations
expires_atExpiration (72 hours from creation)
claim_tokenToken to convert to permanent project

Limits:

  • 5 instant databases per IP per day
  • Projects expire after 72 hours unless claimed
  • Free tier storage limits apply

Claim Your Project​

Convert a temporary instant-db into a permanent project owned by your account.

POST/api/v1/public/instant-db/claim🔒
curl -X POST https://api.ainative.studio/api/v1/public/instant-db/claim \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "550e8400-e29b-41d4-a716-446655440000",
    "claim_token": "clm_xyz789..."
  }'

Response:

{
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "api_key": "zdb_live_newpermanentkey...",
  "status": "claimed",
  "owner_id": "your-user-id"
}

The temporary tmp_ key is replaced with a permanent zdb_live_ key. All data is preserved.

Use With ZeroDB CLI​

# Create instant DB and configure CLI in one step
npx zerodb-cli init --instant

# Or manually
npx zerodb-cli init
# Paste the api_key and project_id when prompted

Use With MCP Servers​

{
  "mcpServers": {
    "zerodb": {
      "command": "npx",
      "args": ["-y", "ainative-zerodb-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "tmp_a1b2c3d4...",
        "ZERODB_PROJECT_ID": "550e8400-..."
      }
    }
  }
}

For AI Agents​

Instant DB enables zero-human provisioning — agents can create their own database without any user interaction:

  1. POST /api/v1/public/instant-db — get credentials
  2. Use credentials to store vectors, memory, files, or tables
  3. When the user signs up, claim the project to make it permanent

This is the foundation of AINative's agentic experience (AX) — agents operate autonomously without waiting for human setup.