Ada

Ada Conversations API

Read and manage conversations handled by the Ada AI Agent across all supported channels.

GitHub OpenAPI
Business capability
Customer Inquiry Management BC-430.10

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/export/conversations Export conversations in bulk (v2 export) · Return conversations matching the parameters #
Ask an LLM
“How do I export conversations created in a date range from the v2 export endpoint?”
“Can I bulk export conversations that were updated since a certain date?”
Tell an agent
Export conversations created between {created_since} and {created_to} using the v2 export.
Pull every conversation updated since {updated_since} from the v2 export, {page_size} per page.
GET /data_api/v1.4/conversations Export conversations via the legacy Data API v1.4 · Return conversations matching the parameters #
Ask an LLM
“How do I pull conversations from the older Data API v1.4?”
“Does the legacy v1.4 conversations export return a status message with results?”
Tell an agent
Use the legacy Data API v1.4 to fetch conversations created since {created_since}.
Fetch conversations updated between {updated_since} and {updated_to} from Data API v1.4.
POST /v2/conversations/email/ Start an email conversation with a customer · Start a conversation over Ada's email channel #
Ask an LLM
“Can my AI Agent email a customer first to start a conversation?”
“Which reply-from address can I use when the agent starts an email thread?”
Tell an agent
Email {name} at {reply_to} to start a conversation about {subject}.
Start an email conversation with {name} at {reply_to}, subject {subject}, saying {text}, and CC {cc}.
POST /v2/conversations/ Start a conversation on a custom channel · Create a new conversation #
Ask an LLM
“How do I start a new conversation on my custom channel?”
“What happens if I start a conversation without an end user id?”
Tell an agent
Start a new conversation in channel {channel_id}.
Open a conversation in channel {channel_id} for end user {end_user_id}.
GET /v2/conversations/{conversation_id}/ Look up one conversation · Get a conversation #
Ask an LLM
“How do I look up the details of a single conversation by its id?”
“Can I check the current metadata and state of one specific conversation?”
Tell an agent
Get conversation {conversation_id}.
Show me the details of conversation {conversation_id}.
PATCH /v2/conversations/{conversation_id}/ Add metadata to a conversation · Update a conversation #
Ask an LLM
“How do I attach extra metadata to a conversation that's already running?”
“Does updating a conversation's metadata replace it or add to it?”
Tell an agent
Add metadata {metadata} to conversation {conversation_id}.
Tag existing conversation {conversation_id} with metadata {metadata}.
GET /v2/conversations/{conversation_id}/messages/ Read the messages in one conversation · Get conversation messages #
Ask an LLM
“How can I read the full message history of one conversation?”
“What's the most messages I can fetch per page for a single conversation?”
Tell an agent
Show me the messages in conversation {conversation_id}.
Get the next {limit} messages of conversation {conversation_id} after cursor {cursor}.
POST /v2/conversations/{conversation_id}/messages/ Send a message into a conversation · Create a new message #
Ask an LLM
“How do I post an end user's message into an ongoing conversation?”
“Can I send a file message after uploading an attachment?”
Tell an agent
Send message {content} from {author} in conversation {conversation_id}.
Post {content} as {author} to conversation {conversation_id}.
POST /v2/conversations/{conversation_id}/end/ End a conversation · End a conversation #
Ask an LLM
“How do I close out a conversation once the customer is done?”
“Can I programmatically end a conversation from my custom channel?”
Tell an agent destructive · confirm first
End conversation {conversation_id}.
Close conversation {conversation_id} for good.
POST /v2/conversations/{conversation_id}/end-handoff/ Hand a conversation back to the AI Agent · End Handoff #
Ask an LLM
“How do I return a conversation from a human agent back to the AI Agent?”
“Does ending a handoff also end the whole conversation?”
Tell an agent
End the human handoff in conversation {conversation_id}.
Give control of conversation {conversation_id} back to the AI Agent without closing it.
POST /v2/conversations/{conversation_id}/attachments/ Upload a file to a conversation · Upload a file attachment #
Ask an LLM
“How do I share a file with a customer in a conversation?”
“How large can a conversation attachment be, and how long does its link last?”
Tell an agent
Upload {file} to conversation {conversation_id}.
Attach file {file} to conversation {conversation_id} and give me the temporary URL.

Documentation

📖
Documentation
https://docs.ada.cx/reference/introduction/overview
📖
Documentation
https://docs.ada.cx/reference/data-export/overview
📖
Documentation
https://developers.ada.cx/reference/data-compliance/overview
📖
Documentation
https://docs.ada.cx/reference/conversations/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/openapi/ada-conversations-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/json-schema/ada-conversation-3-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/json-schema/ada-email-conversation-create-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/json-schema/ada-conversation-create-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/json-schema/ada-message-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/json-schema/ada-conversation-patch-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/json-schema/ada-attachment-upload-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ada:ada-conversations-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ada-conversations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Ada Conversations API
  version: 1.0.0
  description: 'Operations tagged conversations across 3 of this provider''s published API definitions: ada-data-export-openapi.yml, ada-data-export-v1-4-openapi.yml, ada-knowledge-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://example.ada.support/api
  description: https://example.ada.support/api
- url: https://example.ada.support
  description: https://example.ada.support/
tags:


# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ada/refs/heads/main/openapi/ada-conversations-api-openapi.yml