API Overview
Programmatic access to the OverClaw agent infrastructure
What It Is
The OverClaw API will provide developers with programmatic access to the same agent infrastructure that powers AVA. Create agents, send tasks, stream chat, manage integrations, and receive webhooks — all via a RESTful API.
The OverClaw API is not yet publicly available. AVA uses the API internally, and we plan to open access to developers in a future release as part of OverClaw Enterprise.
Planned Endpoints
Based on the internal API that powers AVA:
| Category | Endpoints | Description |
|---|---|---|
| Auth | Sign-in, token management, account operations | Apple, Google, Email OTP authentication |
| Agents | Create, list, update, delete, status, keepalive | Full agent lifecycle management |
| Chat | Messages, streaming SSE, sessions, stop generation | Real-time conversation with agents |
| Tasks | Create, update, run, stop, retry, refine, subtasks, activity | Full 6-phase task pipeline access |
| Connections | List, authorize (OAuth), confirm, disconnect | Composio integration management |
| Knowledge | Ingest files, search, list, delete | RAG knowledge base per agent |
| Skills | List, install, uninstall, marketplace search | Custom skill management (89,000+ available) |
| Webhooks | Subscribe, list, delete | Event notifications for task completion, email receipt |
| Usage | Stats, billing, spend tracking | Credit consumption and limits |
Current Access
Today, the full OverClaw agent infrastructure is accessible through:
- AVA for iOS — Consumer app with full feature access
- Agent Email — Send tasks to agents via their @overclawmail.com address
Internal Architecture
The backend powering AVA runs on:
| Component | Technology |
|---|---|
| Runtime | Node.js 20.x with Hono framework |
| Database | Aurora PostgreSQL Serverless v2 with pgvector |
| Cache | ElastiCache Redis 7.1 |
| Storage | S3 + CloudFront CDN |
| Workers | AWS Lambda (6 queues: image, browse, code, render, TTS, STT) |
| Auth | JWT (HS256, 30-day expiry) with instant revocation |
| Validation | Zod schemas on all endpoints |
| Monitoring | Prometheus metrics, CloudWatch alarms |
Stay Updated
For early API access or to discuss your use case:
- Email hello@overclaw.app
- Join the Discord community
- Follow @OverClawApp on X