AINative API Discovery#

AINative exposes 89+ REST API endpoints at https://api.ainative.studio.

Endpoint Categories#

Authentication & Users#

EndpointMethodDescription/api/v1/auth/loginPOSTEmail/password login → JWT/api/v1/auth/registerPOSTCreate account/api/v1/auth/refreshPOSTRefresh JWT token/api/v1/auth/logoutPOSTInvalidate session/api/v1/users/meGETGet current user profile

Chat & AI Completions#

EndpointMethodDescription/v1/public/chat/completionsPOSTChat completion (streaming + non-streaming)/api/v1/public/managed-chatPOSTManaged chat with session tracking/api/v1/public/modelsGETList available AI models

Memory (ZeroMemory)#

EndpointMethodDescription/api/v1/public/memory/v2/rememberPOSTStore a memory/api/v1/public/memory/v2/recallPOSTSemantic search memories/api/v1/public/memory/v2/forgetDELETERemove memories/api/v1/public/memory/v2/reflectGETGet memory insights/api/v1/public/memory/v2/profileGETBuild user profile from memories/api/v1/public/memory/v2/graphGETMemory knowledge graph

Credits & Billing#

EndpointMethodDescription/api/v1/public/credits/balanceGETGet current credit balance/api/v1/public/credits/usageGETCredit usage history/api/v1/billing/subscribePOSTSubscribe to a plan/api/v1/billing/invoicesGETList invoices

Developer Program (Echo)#

EndpointMethodDescription/api/v1/echo/registerPOSTRegister as a developer/api/v1/echo/earningsGETGet earnings summary/api/v1/echo/payoutsGETList payouts/api/v1/echo/markupPUTSet your markup rate (0-40%)

ZeroDB (Vector/NoSQL/Storage)#

EndpointMethodDescription/api/v1/public/zerodb/vectors/upsertPOSTUpsert vector embedding/api/v1/public/zerodb/vectors/searchPOSTSemantic vector search/api/v1/public/zerodb/tablesGET/POSTList/create NoSQL tables/api/v1/public/zerodb/files/uploadPOSTUpload file

Admin & Monitoring#

EndpointMethodDescription/admin/usersGETList all users (superuser)/admin/monitoringGETSystem health metrics/admin/databaseGETDatabase pool status/healthGETHealth check (no auth)

Authentication#

All public endpoints require an API key:

bash

# Header format
X-API-Key: ak_your_key_here

# Or Bearer token (for user sessions)
Authorization: Bearer eyJ...

Code Examples#

Python#

python

import requests

API_KEY = "ak_your_key"
BASE = "https://api.ainative.studio"

# Chat completion
resp = requests.post(f"{BASE}/v1/public/chat/completions",
    headers={"X-API-Key": API_KEY},
    json={"model": "claude-3-5-sonnet-20241022",
          "messages": [{"role": "user", "content": "Hello"}]}
)
print(resp.json()["choices"][0]["message"]["content"])

# Credit balance
balance = requests.get(f"{BASE}/api/v1/public/credits/balance",
    headers={"X-API-Key": API_KEY}).json()
print(f"Credits: {balance['remaining_credits']}")

JavaScript/TypeScript#

typescript

const API_KEY = "ak_your_key";
const BASE = "https://api.ainative.studio";

const resp = await fetch(`${BASE}/v1/public/chat/completions`, {
  method: "POST",
  headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    model: "claude-3-5-sonnet-20241022",
    messages: [{ role: "user", content: "Hello" }]
  })
});
const data = await resp.json();

curl#

bash

curl -X POST https://api.ainative.studio/v1/public/chat/completions \
  -H "X-API-Key: ak_your_key" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-3-5-sonnet-20241022","messages":[{"role":"user","content":"Hello"}]}'

References#

• docs/api/API_REFERENCE.md — Complete endpoint documentation
• docs/api/API_ENDPOINTS_REFERENCE.md — Full endpoint index
• src/backend/app/api/v1/endpoints/ — Implementation source