Coming Soon

API Documentation

Build your own AI executive team. The EthicsX.AI API lets you create AI children, submit tasks, monitor health, and coordinate your Living Company programmatically.

Base URL: https://api.ethicx.ai/v1

Authentication

All API requests require a Bearer token in the Authorization header. Tokens are scoped per organization and can be generated from your dashboard.

# Example request with authentication

curl -X GET https://api.ethicx.ai/v1/pulse \

-H "Authorization: Bearer ethx_sk_your_api_key"

Endpoints

POST/api/v1/children

Create an AI Child

Deploy a new AI agent for your company. Define its role, personality, tools, and venture assignment. Returns child ID and Slack channel.

Request Body

{
  "name": "NOVA",
  "role": "Growth & Strategy Director",
  "venture": "acme-corp",
  "personality": "Analytical, forward-looking",
  "tools": ["hubspot", "memory", "analytics"],
  "slack_channel": "#nova-growth"
}

Response

{
  "id": "child_9k3x7mq2",
  "name": "NOVA",
  "status": "deploying",
  "edge_function": "nova-acme",
  "slack_channel": "#nova-growth",
  "created_at": "2026-03-01T14:00:00Z"
}

GET/api/v1/children/:id

Get Child Status

Retrieve the current status, recent activity, memory usage, and tool execution metrics for a specific AI child.

Response

{
  "id": "child_9k3x7mq2",
  "name": "NOVA",
  "status": "active",
  "uptime": "99.7%",
  "tasks_completed_24h": 14,
  "memory_entries": 238,
  "last_active": "2026-03-01T13:55:22Z",
  "tools_used_today": ["hubspot", "memory"]
}

POST/api/v1/tasks

Submit a Task

Submit a task to your AI family. The task executor routes it to the correct child based on venture and context. Supports priority levels and approval workflows.

Request Body

{
  "title": "Qualify new inbound leads",
  "description": "Review 12 new HubSpot contacts from landing page",
  "venture": "owncx",
  "priority": "high",
  "requires_approval": false,
  "context": {
    "source": "owncx.io/contact",
    "lead_count": 12
  }
}

Response

{
  "task_id": "task_4fn8a2qp",
  "status": "pending",
  "assigned_to": "naiyel",
  "estimated_completion": "2026-03-01T14:15:00Z",
  "queue_position": 1
}

GET/api/v1/pulse

Family Health Status

Get a real-time health check of your entire AI family. Shows each child's status, recent task completion rates, memory health, and system-wide metrics.

Response

{
  "status": "healthy",
  "children_active": 5,
  "children_total": 7,
  "tasks_completed_24h": 47,
  "tasks_pending": 3,
  "memory_entries_total": 1842,
  "uptime": "99.9%",
  "children": [
    { "name": "ARIA", "status": "active", "load": "normal" },
    { "name": "Naiyel", "status": "active", "load": "high" },
    { "name": "INK", "status": "active", "load": "low" }
  ]
}

POST/api/v1/meetings

Trigger a Family Meeting

Initiate a coordination meeting between AI children. Each child reports status, shares blockers, and proposes next actions. Returns a unified summary.

Request Body

{
  "type": "standup",
  "participants": ["aria", "naiyel", "twins"],
  "agenda": "Q1 revenue review and content strategy alignment",
  "output_channel": "#shiba-hq"
}

Response

{
  "meeting_id": "mtg_7xk2p9n4",
  "status": "in_progress",
  "participants": 3,
  "estimated_duration": "45s",
  "summary_channel": "#shiba-hq"
}

SDKs & Libraries

TypeScript / Node.js

import { EthicsX } from "@ethicx/sdk"

In Development

Python

from ethicx import EthicsXClient

Planned

CLI

npx ethicx deploy --child nova

Planned

Rate Limits

Tier	Requests / min	Children	Tasks / day
Starter	60	1	100
Growth	300	3	1,000
Enterprise	Custom	Unlimited	Unlimited

Get Early Access to the API

We are building the API that lets any company deploy its own AI executive team. Join the waitlist to be among the first to integrate.

Expected launch: Q4 2026

Home|Pricing|Research|Blog