# AAAAI Platform API **Canonical:** https://apis.io/apis/aaaai-me/aaaai-platform-api/ **Provider:** AAA AI — https://apis.io/providers/aaaai-me/ **Base URL:** https://web.aaaai.me **Documentation:** https://web.aaaai.me/apidocs AAAAI Platform API is one of 2 APIs that [AAA AI](https://apis.io/providers/aaaai-me/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Artificial Intelligence, Agents, Multi-Agent, OpenAI-Compatible, and Workflows. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation. REST API of the AAA AI workspace, published as Swagger 2.0 "AAAAI API" 1.1.0 (host web.aaaai.me, 79 paths, 102 operations, no operationIds, empty definitions) at https://web.aaaai.me/api/spec.json — the document the Flasgger UI at /apidocs loads; every provider discovery file instead names /apispec_1.json, which is a 404. Covers health, auth (login, register, Sign in with Apple, delete account), the current user, chats with messages and attachments, one-shot and SSE-streamed queries, OpenAI-compatible /v1/models and /v1/chat/completions, code-only generation, audio transcription and speech, expert-pool and dynamic-expert management, cognitive scaling, exec approvals (X-Agent-Token), cron jobs, background goal jobs, the Deep Agent, single-tool invocation on paired device agents, dev-preview sessions, connected nodes, video sessions, memories and per-user settings including MCP platform profiles. Auth is an X-User-Login header or session cookie; /api/health answers anonymously. ## Operations (60 of 102) | Method | Path | Summary | |---|---|---| | GET | `/api/approvals` | List exec approvals (pending destructive commands) | | POST | `/api/approvals` | Create approval (agent when destructive + no TTY). Header: X-Agent-Token. | | GET | `/api/approvals/{approval_id}` | Get approval status (agent polling) | | POST | `/api/approvals/{approval_id}/resolve` | Resolve approval (approve/reject) | | POST | `/api/ask` | Simple ask (single question) | | POST | `/api/audio/speech` | Generate speech audio from text | | POST | `/api/audio/transcribe` | Transcribe audio (speech-to-text) | | GET | `/api/audio/voices` | List available TTS voices | | POST | `/api/auth/apple` | Sign in with Apple | | POST | `/api/auth/delete-account` | Delete account | | POST | `/api/auth/login` | Login | | POST | `/api/auth/logout` | Logout | | POST | `/api/auth/register` | Register new user | | GET | `/api/chats` | List chats | | POST | `/api/chats` | Create chat | | DELETE | `/api/chats/{chat_id}` | Delete chat | | GET | `/api/chats/{chat_id}` | Get chat by ID | | PUT | `/api/chats/{chat_id}` | Update chat (e.g. title) | | DELETE | `/api/chats/{chat_id}/attachments` | Clear attachments for chat | | GET | `/api/chats/{chat_id}/attachments` | List attachments for chat | | POST | `/api/chats/{chat_id}/attachments` | Upload attachment | | DELETE | `/api/chats/{chat_id}/attachments/{attachment_id}` | Delete single attachment | | POST | `/api/chats/{chat_id}/messages` | Post message to chat (query with optional attachments) | | POST | `/api/code` | Generate code only (Cursor / CLI / IDE integration) | | POST | `/api/coding-feedback` | Submit coding feedback | | POST | `/api/coding-memory/bootstrap` | Bootstrap coding memory | | GET | `/api/cognitive-scaling/memory` | Get recent cognitive scaling decisions | | GET | `/api/cognitive-scaling/status` | Get cognitive scaling status | | POST | `/api/cognitive-scaling/toggle` | Toggle cognitive scaling | | GET | `/api/cron/jobs` | List scheduled cron jobs (OpenClaw-style) | | POST | `/api/cron/jobs` | Create cron job | | DELETE | `/api/cron/jobs/{job_id}` | Delete cron job | | GET | `/api/cron/jobs/{job_id}` | Get cron job | | POST | `/api/cron/jobs/{job_id}/trigger` | Run cron job now | | GET | `/api/debug/search` | Debug search | | POST | `/api/deep-agent/chat` | Chat with the Deep Agent (multi-turn, session-based). | | POST | `/api/deep-agent/run` | Run a task through the Deep Agent (one-shot). | | GET | `/api/deep-agent/status` | Get Deep Agent status. | | GET | `/api/dev-preview/sessions` | List remote preview sessions for the authenticated user | | POST | `/api/dev-preview/start` | Start a remote preview/dev server on the authenticated user's linked agent | | POST | `/api/dev-preview/stop` | Stop a remote preview session | | POST | `/api/dev-preview/test` | Run Playwright checks against a remote preview URL | | POST | `/api/dynamic-experts/create` | Create custom expert | | GET | `/api/dynamic-experts/list` | List dynamically created experts | | GET | `/api/dynamic-experts/status` | Get dynamic experts status | | POST | `/api/dynamic-experts/toggle` | Toggle dynamic expert creation | | DELETE | `/api/dynamic-experts/{expert_id}` | Delete dynamic expert | | PATCH | `/api/dynamic-experts/{expert_id}` | Update dynamic expert | | POST | `/api/experts/add` | Add expert to pool (existing type or custom) | | POST | `/api/experts/auto-scale` | Toggle auto-scaling | | POST | `/api/experts/edit` | Edit expert (name/provider/model) | | POST | `/api/experts/remove` | Remove expert from pool | | POST | `/api/experts/scale-down` | Scale down (remove optional experts) | | POST | `/api/experts/scale-up` | Scale up (add all missing experts) | | GET | `/api/experts/settings` | Get expert model settings | | POST | `/api/experts/settings` | Apply expert model settings | | PUT | `/api/experts/settings` | Update expert model settings | | GET | `/api/experts/status` | Get expert system status | | GET | `/api/goal-jobs` | List background goal jobs for the current user | | GET | `/api/goal-jobs/{job_id}` | Get background goal job status | …and 42 more operations. They are listed in full on the page. ## Machine-readable artifacts (8) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/aaaai-me/refs/heads/main/openapi/aaaai-me-openapi.json - **OpenAPI** — https://web.aaaai.me/api/spec.json - **APIReference** — https://web.aaaai.me/apidocs - **Documentation** — https://aaaai.me/docs.html - **Overlay** — https://raw.githubusercontent.com/api-evangelist/aaaai-me/refs/heads/main/overlays/aaaai-me-openapi-overlay.yaml - **DataModel** — https://raw.githubusercontent.com/api-evangelist/aaaai-me/refs/heads/main/data-model/aaaai-me-data-model.yml - **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/aaaai-me/refs/heads/main/errors/aaaai-me-problem-types.yml - **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/aaaai-me/refs/heads/main/apis.yml ## Other AAA AI APIs (1) - [AAA AI Agent Checkout (Billing) API](https://apis.io/apis/aaaai-me/aaaai-agent-checkout-api/) ## Tags Artificial Intelligence, Agents, Multi-Agent, OpenAI-Compatible, Workflows --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/aaaai-me/aaaai-platform-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/aaaai-me/.