Ainative Api Discovery

Help agents discover and navigate AINative's 89+ API endpoints. Use when (1) Asking "what endpoints exist?", (2) Finding the right API for a task, (3) Lookin...

Security Scan

The skill is an instruction-only API reference for AINative endpoints and examples; it requires no installs or credentials and its requested capabilities match its stated purpose.

Purpose & Capability

The name/description promise — discover and navigate AINative endpoints — matches the SKILL.md content: a catalog of endpoints, authentication notes, and code examples. It does not ask for unrelated credentials or binaries.

Instruction Scope

SKILL.md contains only endpoint listings, auth header format, and client examples (Python/JS/curl). It does not instruct the agent to read local files, environment variables, or send data to unexpected endpoints. It does reference internal repo paths and documentation files, but these are citations only (no file reads are requested).

Install Mechanism

No install spec and no code files — instruction-only skill. This minimizes on-disk risk since nothing is downloaded or executed by an installer.

Credentials

The skill declares no required env vars or credentials. Examples mention an API key placeholder (X-API-Key) which is expected for API usage; there are no demands for unrelated secrets.

Persistence & Privilege

always:false (default) and no requests to modify other skills or system settings. Autonomous invocation is allowed (platform default) but not excessive for this type of helper.

Assessment

This appears to be a documentation-only skill listing AINative endpoints and example calls, so it is internally consistent. Before using it: (1) verify the API host (https://api.ainative.studio) is legitimate for your use case before sending real secrets, (2) never paste actual API keys or sensitive tokens into chat prompts — use environment or secure stores during development, (3) note that some endpoints shown (e.g., /admin/*) are privileged — the skill simply documents them but calling them would require elevated credentials, and (4) because the skill's source/homepage is unknown, exercise normal caution and prefer testing in an isolated environment if you plan to automate calls.

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

Endpoint Categories

Authentication & Users

Endpoint	Method	Description
/api/v1/auth/login	POST	Email/password login → JWT
/api/v1/auth/register	POST	Create account
/api/v1/auth/refresh	POST	Refresh JWT token
/api/v1/auth/logout	POST	Invalidate session
/api/v1/users/me	GET	Get current user profile

Chat & AI Completions

Endpoint	Method	Description
/v1/public/chat/completions	POST	Chat completion (streaming + non-streaming)
/api/v1/public/managed-chat	POST	Managed chat with session tracking
/api/v1/public/models	GET	List available AI models

Memory (ZeroMemory)

Endpoint	Method	Description
/api/v1/public/memory/v2/remember	POST	Store a memory
/api/v1/public/memory/v2/recall	POST	Semantic search memories
/api/v1/public/memory/v2/forget	DELETE	Remove memories
/api/v1/public/memory/v2/reflect	GET	Get memory insights
/api/v1/public/memory/v2/profile	GET	Build user profile from memories
/api/v1/public/memory/v2/graph	GET	Memory knowledge graph

Credits & Billing

Endpoint	Method	Description
/api/v1/public/credits/balance	GET	Get current credit balance
/api/v1/public/credits/usage	GET	Credit usage history
/api/v1/billing/subscribe	POST	Subscribe to a plan
/api/v1/billing/invoices	GET	List invoices

Developer Program (Echo)

Endpoint	Method	Description
/api/v1/echo/register	POST	Register as a developer
/api/v1/echo/earnings	GET	Get earnings summary
/api/v1/echo/payouts	GET	List payouts
/api/v1/echo/markup	PUT	Set your markup rate (0-40%)

ZeroDB (Vector/NoSQL/Storage)

Endpoint	Method	Description
/api/v1/public/zerodb/vectors/upsert	POST	Upsert vector embedding
/api/v1/public/zerodb/vectors/search	POST	Semantic vector search
/api/v1/public/zerodb/tables	GET/POST	List/create NoSQL tables
/api/v1/public/zerodb/files/upload	POST	Upload file

Admin & Monitoring

Endpoint	Method	Description
/admin/users	GET	List all users (superuser)
/admin/monitoring	GET	System health metrics
/admin/database	GET	Database pool status
/health	GET	Health check (no auth)

Authentication

All public endpoints require an API key:

# Header format
X-API-Key: ak_your_key_here

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

Code Examples

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

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

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