Subscribe to release notes

Welcome to Ada’s release notes. Scroll down to see a list of recent releases.

You can subscribe to updates with our RSS feed, or sign up to get news about updates directly in your inbox.

At the end of every week that has had at least one feature release, we’ll send you an email on Friday at 11 a.m. Eastern to let you know about our last few releases.

March 30, 2026

Handoffs API now generally available

The Handoffs API is now generally available. It enables custom handoff integrations that connect an AI Agent to any live agent platform or internal system, without requiring Ada Solutions engineering.

API endpoints

Five REST endpoints are available for managing conversations during an active handoff:

  • Send message (POST /v2/conversations/{conversation_id}/messages/): Send messages from a human agent to the end user during a handoff.
  • Get messages (GET /v2/conversations/{conversation_id}/messages/): Retrieve the full conversation transcript with pagination. Supports text, file, and link content types.
  • Upload attachment (POST /v2/conversations/{conversation_id}/attachments/): Upload files up to 50 MB to a conversation via presigned URL. Returns a download URL valid for 7 days.
  • Update conversation (PATCH /v2/conversations/{conversation_id}/): Update conversation metadata. Supports string, boolean, integer, and float values.
  • End handoff (POST /v2/conversations/{conversation_id}/end-handoff/): End the handoff and return control to the AI Agent.

Webhook events

Two webhook events support real-time integration during handoffs:

  • v1.conversation.message: Fires on every message during an active handoff, delivering text, file, or link content in real time.
  • v1.conversation.handoff.ended: Fires when a handoff completes, enabling cleanup and state sync in external systems.

Integration features

  • handoff_integration field: Identifies which integration is active on a conversation. Use it with Svix Channels to filter webhook deliveries so each integration only receives its own events.
  • ai_agent_domain field: Included in all webhook events. Identifies which AI Agent environment the event originated from (for example, acme.ada.support or acme.eu.ada.support). Essential for multi-Agent or multi-region setups.
  • HTTP Request Block trigger: Start a handoff by configuring an HTTP Request Block in the AI Agent’s automation. The block calls the integration’s endpoint and signals the handoff start.
  • Svix Channels filtering: Filter webhook deliveries by handoff_integration value so each integration only receives relevant events.

Get started

  • Conversations API reference for endpoint details, authentication, error codes, rate limits, and Svix webhook verification.
  • Creating a custom handoff: A step-by-step developer guide covering the full integration lifecycle, from configuring the handoff trigger to sending messages, handling file attachments, and returning control to the AI Agent.
  • ada-handoffs-api-demo: An open-source reference app demonstrating the full handoff lifecycle, including agent messaging, file uploads, transcript rendering, and handoff termination.