← Back to Skills Marketplace
urbantech

Ainative Api Discovery

by Toby Morning · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
207
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install ainative-api-discovery
Description
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...
README (SKILL.md)

AINative API Discovery

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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: ainative-api-discovery Version: 1.0.0 The skill bundle is a documentation-only resource providing an index and usage examples for the AINative API (api.ainative.studio). It contains no executable code, no suspicious instructions, and no indicators of data exfiltration or malicious intent in SKILL.md or _meta.json.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ainative-api-discovery
  3. After installation, invoke the skill by name or use /ainative-api-discovery
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: provides comprehensive AINative API discovery and navigation. - Lists and describes 89+ REST API endpoints categorized by feature (auth, chat, memory, billing, developer, storage, admin). - Offers example code in Python, JavaScript/TypeScript, and curl for key endpoints. - Details authentication methods (API key, bearer token). - Includes quick references to full documentation and source code locations. - Enables agents to search endpoints, find usage patterns, and explore API capabilities efficiently.
Metadata
Slug ainative-api-discovery
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 207 downloads so far.

How do I install Ainative Api Discovery?

Run "/install ainative-api-discovery" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ainative Api Discovery free?

Yes, Ainative Api Discovery is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Ainative Api Discovery support?

Ainative Api Discovery is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ainative Api Discovery?

It is built and maintained by Toby Morning (@urbantech); the current version is v1.0.0.

💬 Comments