August 2026
1
Aug β API: choose the sender number on channel threads
API Β· SDK
POST /messaging/v1/channels/{channel}/threads now accepts an optional
sender_id β the MongoDB ObjectId of a sender you connected in the AUI
playground. Pass it to start the conversation from that connected
number. Omit it to keep using the platform default sender.phone_number remains the recipient. When a specific sender is used,
the response includes from so you can confirm which connected number
sent the opener.See Channels and the
SDK messaging client.July 2026
1
Jul β API: structured card data (json_data)
API
breakingAgent reply cards now carry the entity in two self-contained
representations: rendered_jsx (unchanged β a ready-to-render JSX string
for React UIs) and the new json_data β the same card as structured JSON,
so you can build your own card UI in any framework (Vue, Angular, mobile).json_data.entity is a flat keyβvalue map of the cardβs fields, and
json_data.sub_entities holds nested groups such as product variants.The cardβs previous name, category, and parameters fields were
removed β everything you need to render is in json_data.See Cards.2
Jul β API: agent version on thread lists
API
GET /management/v1/threads items now include version_tag β the agent
version the conversation ran on. Use it to tell which release of your
agent handled each thread when filtering or auditing conversations.See Management β Threads.3
Jul β API: new base URL
API
breakingThe API base URL changed from https://api-v3.aui.io/apollo-api-v2 to
https://api-v3.aui.io/apollo-api. All paths under it are unchanged
(e.g. POST /messaging/v1/messages, POST /management/v1/auth/token).The old base URL keeps working for a few more days to give you time to
migrate, and will then be removed β switch to the new one now.4
Jul β API: agent_id removed from messaging request bodies
API
breakingYour agent is now identified by your access token: when you exchange a
publishable key at POST /management/v1/auth/token, the resulting token
already carries the agent. Sending agent_id in the body of
POST /messaging/v1/messages, POST /messaging/v1/messages/stream, or
POST /messaging/v1/threads/{threadId}/rerun is no longer accepted and
returns a validation error (422).Migration: remove agent_id from your messaging request bodies β
responses keep the same shape. See Send messages.5
Jul β API: channel thread initiation (WhatsApp / SMS)
API
breakingThe POST /messaging/v1/channels/{channel}/threads request body changed:agent_idwas removed β the agent now comes from your access token.user_ref_idwas renamed touser_id.template_idandcontent_variables(WhatsApp template overrides) were removed β the agentβs configured template is always used;agent_display_nameremains available.
6
Jul β SDK v3: new clients for the Apollo API
SDK
breaking Β· v3.2@aui.io/aui-client v3 is a full rewrite against the Apollo API. The
single ApolloClient is replaced by two clients, one per credential:ApolloMessagingClientβ publishable key, browser-safe. Token exchange and refresh are handled internally; the agent comes from the key, not request bodies. Messaging, channels, and WebSocket sessions.ApolloManagementClientβ organization API key, server-side only. Projects, agents, versions, threads, and usage.
createTask is gone (threads auto-create on the
first sendMessage), task_id became thread_id, and the client
defaults to the production API with no environment configuration. See the
migration guide.7
Jul β API: threads, agent variables, welcome message & follow-up suggestions
API
new- Update a thread β
PATCH /management/v1/threads/{threadId}renames a thread (title); the full updated thread is returned. - Agent variables β
POST /messaging/v1/messagesandPOST /messaging/v1/messages/streamaccept an optionalagent_variablesobject (staticanddynamic) with per-message values for the agentβs configured context variables. - Welcome message β
GET /messaging/v1/welcome-messagereturns your agentβs configured greeting, for opening a conversation UI before the first message. - Follow-up suggestions β
POST /messaging/v1/followup-suggestionsgenerates suggested next prompts from a context you provide.
8
CLI v0.4 β Runtime testing, versions, integrations & more
CLI
beta Β· v0.4.45- Runtime messaging β talk to your agent against the live Apollo-1 runtime with
aui apollo(create-thread,send-message,rerun,trace). Local.aui.jsonedits are forwarded automatically, and every reply includes the symbolic trace. - Version management β full lifecycle with
aui version(draft β publish β activate β archive) plus point-in-time comparison viaaui version snapshot diff. - Integrations β create and test manual MCP and native Composio integrations with
aui integration(discover,tools,toolkits,mcp-url,create,test,mcp-test). - Mock DB β spin up a per-agent test database with
aui mockdb(collections, seed data, endpoints, sessions, key rotation). - Evaluation scenarios β generate, push, and score scenarios with
aui scenariosto turn a faithful agent into a reliable one. - Secrets β store and rotate integration credentials with
aui vault. - Coding-agent first β nearly every command is non-interactive with a
--jsonmode; imports scaffold skills for Cursor, Claude Code, and opencode;aui reportsurfaces issues and learnings. - Quality-of-life β
aui agent --createprovisions an agent end-to-end and imports it locally;aui sync-sessionkeeps your session scoped to the project;aui servelaunches a local web playground;aui curl,aui upgrade, andaui revertround out the toolset. Neweu-productionenvironment.
March 2026
1
Mar 9 β CLI Beta Release
CLI
beta- Public beta of
aui-agent-builderCLI (v0.1.77) - Local-first development workflow: import, edit, validate, and push agent configurations
- Interactive chat and web playground via
aui chatandaui serve - Smart push with git-based diffing
2
Mar 9 β Agent Builder API Alpha
Agent Builder API
alpha Β· Closed to the public- Alpha release of the Agent Builder API β available to select partners only
- Identity, organizations, accounts, and networks (agents) endpoints
- Agent settings read/write: tools, parameters, entities, integrations, rules
- Knowledge base management with file upload and website scraping
- API Workflow integration generator