API Documentation

Comprehensive API reference for integrating Automa8 AI agents into your systems. All endpoints use tRPC with automatic type safety.

Quick Start

Installation

npm install @automa8/sdk

Authentication

All API requests require authentication via your Manus OAuth session. The tRPC client automatically handles this.

import { trpc } from '@automa8/sdk';

// Automatically authenticated via session cookie
const result = await trpc.audit.submitResponses.useMutation();

API Endpoints

POST/api/trpc/audit.submitResponses

Submit Agent-Readiness Audit responses and get score

Parameters:

responses: Record<string, number>

Example:

const result = await trpc.audit.submitResponses.useMutation();
await result.mutateAsync({
  responses: {
    "apis": 1,
    "data_formats": 1,
    "monitoring": 0,
    "scalability": 1,
    "security": 1,
    "integration": 1,
    "documentation": 0,
    "governance": 1
  }
});

GET/api/trpc/analytics.getMetrics

Get agent performance metrics

Parameters:

userId: string, timeframe: "24h" | "7d" | "30d"

Example:

const { data: metrics } = trpc.analytics.getMetrics.useQuery({
  userId: "user-123",
  timeframe: "7d"
});

GET/api/trpc/agents.getDeployed

Get list of deployed agents for a user

Parameters:

userId: string

Example:

const { data: agents } = trpc.agents.getDeployed.useQuery({
  userId: "user-123"
});

POST/api/trpc/agents.deploy

Deploy a new autonomous agent

Parameters:

agentConfig: AgentConfig, walletAddress: string

Example:

const deploy = trpc.agents.deploy.useMutation();
await deploy.mutateAsync({
  agentConfig: {
    name: "MyAgent",
    type: "trading",
    capabilities: ["monitoring", "trading"]
  },
  walletAddress: "0x..."
});

GET/api/trpc/leaderboard.getTop

Get top Agent-Ready scores on leaderboard

Parameters:

limit: number

Example:

const { data: leaderboard } = trpc.leaderboard.getTop.useQuery({
  limit: 10
});

GET/api/trpc/profile.getUser

Get user profile and achievements

Parameters:

userId: string

Example:

const { data: profile } = trpc.profile.getUser.useQuery({
  userId: "user-123"
});

SDK Examples

JavaScript/TypeScript

import { trpc } from '@automa8/sdk';

// Query data
const { data } = trpc.agents
  .getDeployed.useQuery({ userId });

// Mutate data
const deploy = trpc.agents
  .deploy.useMutation();
await deploy.mutateAsync(config);

Python

from automa8 import Client

client = Client(api_key="...")

# Get deployed agents
agents = client.agents.get_deployed(
    user_id="user-123"
)

# Deploy new agent
result = client.agents.deploy(
    config=agent_config
)

cURL

curl -X POST \
  https://api.automa8.ai/trpc/audit.submitResponses \
  -H "Content-Type: application/json" \
  -d '{
    "responses": {
      "apis": 1,
      "data_formats": 1
    }
  }'

REST API

# All tRPC endpoints available at:
/api/trpc/[procedure]

# Example:
GET /api/trpc/leaderboard.getTop?limit=10
POST /api/trpc/agents.deploy

# Response format:
{
  "result": {
    "data": {...}
  }
}

Rate Limiting & Quotas

•
Standard Tier:
1,000 requests/hour
•
Pro Tier:
10,000 requests/hour
•
Enterprise:
Custom limits

Support & Resources

Documentation

Full API reference with examples and best practices.

Community

Join our Discord community for questions and discussions.

Ready to Integrate?

Start building with Automa8 AI today. Deploy your first autonomous agent in minutes.