Ada Messages API
The messages API from Ada — 2 operation(s) for messages.
Operations 2
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
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ada:ada-messages-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Ada Messages API
version: 1.0.0
description: 'Operations tagged messages across 2 of this provider''s published API definitions: ada-data-export-openapi.yml, ada-data-export-v1-4-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:
- name: Messages
paths:
/v2/export/messages:
get:
operationId: get-messages
summary: Return messages matching the parameters
description: Returns a list of `message` objects along with a `next_page_uri` if applicable
tags:
- Messages
parameters:
- name: created_since
in: query
description: Return records that were created after this date. If `created_to` is not specified, only records within 7 days of this timestamp are returned. To retrieve data beyond that window, set `created_to` explicitly. Must be an ISO 8601 UTC timestamp ending with 'Z' (e.g., `2024-07-01T00:00:00Z`); required for valid API requests.
required: true
schema:
type: string
format: date-time
- name: conversation_id
in: query
description: Return records with a `conversation_id` that matches this id
required: false
schema:
type:
- string
- 'null'
format: id
- name: page_size
in: query
description: Number of records to return in response. The maximum and default is 10000, the minimum is 100.
required: false
schema:
type: integer
default: 10000
- name: created_to
in: query
description: Return records that were created earlier than this date. If not specified, this value defaults to 7 days after `created_since`. Must be an ISO 8601 UTC timestamp ending with 'Z' (e.g., `2024-07-01T00:00:00Z`); required for valid API requests.
required: false
schema:
type:
- string
- 'null'
format: date-time
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Ada successfully processed the request
content:
application/json:
schema:
$ref: '#/components/schemas/MessagesResponse'
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Authorization Error
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
servers:
- url: https://example.ada.support/api
description: https://example.ada.support/api
/data_api/v1.4/messages:
get:
operationId: return-messages-matching-the-parameters
summary: Return messages matching the parameters
description: Returns a list of `message` objects along with a status message and `next_page_uri` if applicable.
tags:
- Messages
parameters:
- name: created_since
in: query
description: Return records that were created after this date. Must be an ISO 8601 UTC timestamp ending with 'Z' (e.g., `2024-07-01T00:00:00Z`); required for valid API requests.
required: true
schema:
type: string
format: date-time
- name: conversation_id
in: query
description: Return records with a `conversation_id` that matches this id.
required: false
schema:
type:
- string
- 'null'
- name: page_size
in: query
description: Number of records to return in response. The maximum and default is 10000, the minimum is 100.
required: false
schema:
type: integer
default: 10000
- name: created_to
in: query
description: Return records that were created earlier than this date. If not specified, this value defaults to 7 days after `created_since`. Must be an ISO 8601 UTC timestamp ending with 'Z' (e.g., `2024-07-01T00:00:00Z`); required for valid API requests.
required: false
schema:
type:
- string
- 'null'
format: date-time
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Ada successfully processed the request.
content:
application/json:
schema:
$ref: '#/components/schemas/MessagesResponse_2'
'400':
description: Incorrect query.
content:
application/json:
schema:
description: Any type
'408':
description: Database query timed out.
content:
application/json:
schema:
description: Any type
'422':
description: Invalid arguments or missing data for a required field.
content:
application/json:
schema:
description: Any type
'429':
description: Requests are within 1 s of each other.
content:
application/json:
schema:
description: Any type
'500':
description: Request timed out or there was a database error.
content:
application/json:
schema:
description: Any type
'502':
description: Nginx gateway issue on Ada's servers.
content:
application/json:
schema:
description: Any type
'503':
description: Server temporarily unable to handle the request.
content:
application/json:
schema:
description: Any type
'504':
description: Temporary infrastructure error on Ada's servers.
content:
application/json:
schema:
description: Any type
servers:
- url: https://example.ada.support
description: https://example.ada.support/
components:
schemas:
Errors:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/ErrorsErrorsItems'
description: A list of errors
required:
- errors
title: Errors
ErrorsErrorsItems:
type: object
properties:
type:
type: string
description: The error type
message:
type: string
description: The error message
details:
type:
- string
- 'null'
description: Extra information about the error
required:
- type
- message
title: ErrorsErrorsItems
Message:
type: object
properties:
_id:
type: string
description: Unique ID for the message record
answer_id:
type:
- string
- 'null'
description: Internal ID of the answer (response) that triggered this message. Null if the message was not sent by an Ada bot, and None if it was sent by a generative bot.
answer_title:
type:
- string
- 'null'
description: Title of the answer (response) that triggered this message. Null if the message was not sent by an Ada bot, or if it was sent by a generative bot.
chatter_id:
type:
- string
- 'null'
description: Internal ID of the chatter who sent this message. Corresponds to the `_id` field of Chatter objects.
conversation_id:
type: string
description: Internal ID of the conversation in which this message was sent. Corresponds to the `_id` field of Conversation objects.
date_created:
type: string
format: date-time
description: Time the record was created (UTC)
link_was_clicked:
type:
- boolean
- 'null'
description: Indicates if the link in the answer (response) was clicked
message_data:
$ref: '#/components/schemas/MessageMessageData'
description: Data associated with this message
recipient:
type: string
description: Recipient of this message
record_last_updated:
type: string
format: date-time
description: Date and time the record was uploaded to the API (UTC)
review:
type: integer
description: Rating given to this answer by the chatter
sender:
type: string
description: Sender of this message
in_response_to:
type: string
description: Internal ID of the message that this message is in response to. None if the message is not in response to another message.
title: Message
MessagesResponseMeta:
type: object
properties:
next_page_uri:
type:
- string
- 'null'
description: Link to the next page of results matching the query
title: MessagesResponseMeta
MessagesResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Message'
description: Records returned from the query
meta:
$ref: '#/components/schemas/MessagesResponseMeta'
title: MessagesResponse
MessageMessageData:
type: object
properties: {}
description: Data associated with this message
title: MessageMessageData
Message_2:
type: object
properties:
_id:
type: string
description: Unique ID for the message record
answer_id:
type: string
description: Internal ID of the answer (response) that triggered this message. Null if the message was not sent by an Ada bot, and None if it was sent by a generative bot
answer_title:
type: string
description: Title of the answer (response) that triggered this message. Null if the message was not sent by an Ada bot, or if it was sent by a generative bot
chatter_id:
type: string
description: Internal ID of the chatter who sent this message. Corresponds to the `_id` field of Chatter objects
conversation_id:
type: string
description: Internal ID of the conversation in which this message was sent. Corresponds to the `_id` field of Conversation objects
date_created:
type: string
format: date-time
description: Time the record was created (UTC)
link_was_clicked:
type: boolean
description: Indicates if the link in the answer (response) was clicked
message_data:
$ref: '#/components/schemas/MessageMessageData'
description: Data associated with this message
recipient:
type: string
description: Recipient of this message
record_last_updated:
type: string
format: date-time
description: Date and time the record was uploaded to the API (UTC)
review:
type: integer
description: Rating given to this answer by the chatter
sender:
type: string
description: Sender of this message
in_response_to:
type: string
description: Internal ID of the message that this message is in response to. None if the message is not in response to another message
title: Message
MessagesResponse_2:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Message_2'
description: Records returned from the query
message:
type: string
description: Request status message
next_page_uri:
type: string
description: Relative link to the next page of results matching the query
title: MessagesResponse
securitySchemes:
bearerAuth:
type: http
scheme: bearer
x-refined-from:
- ada-data-export-openapi.yml
- ada-data-export-v1-4-openapi.yml