Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Ada subpackage_conversations API

The subpackage_conversations API from Ada — 9 operation(s) for subpackage_conversations.

Ada subpackage_conversations API is one of 13 APIs that Ada publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include subpackage_conversations. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 11 operations across 9 paths, and defines 43 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 5 base URLs: https://example.ada.support, https://example.att.ada.support, https://example.maple.ada.support, https://example.ficanex.ada.support, https://example.eu.ada.support.

11 operations 9 paths 43 schemas 4 GET1 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.ada.cx
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Ada subpackage_conversations API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

Paths & Operations 11

Across 9 paths, the API surfaces 11 operations — 4 GET, 1 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

subpackage_conversations 11
GET
/v2/export/conversations
Return conversations matching the parameters
get-conversations 6 params → 200400401403404429500
GET
/data_api/v1.4/conversations
Return conversations matching the parameters
return-conversations-matching-the-parameters 6 params → 200400408422429500502503
POST
/v2/conversations/email/
Start a conversation over Ada's email channel
create-email-conversation 1 param body → 200400401422429500
POST
/v2/conversations/
Create a new conversation
create-conversation 1 param body → 201400401404429500
GET
/v2/conversations/{conversation_id}/
Get a conversation
get-conversation-by-id 2 params → 200400401404429500
PATCH
/v2/conversations/{conversation_id}/
Update a conversation
patch-conversation-by-id 2 params body → 200400401404429500
GET
/v2/conversations/{conversation_id}/messages/
Get conversation messages
fetch-conversation-messages-by-id 4 params → 200400401404429500
POST
/v2/conversations/{conversation_id}/messages/
Create a new message
create-message 2 params body → 201400401404429500
POST
/v2/conversations/{conversation_id}/end/
End a conversation
end-conversation 2 params → 200400401404429500
POST
/v2/conversations/{conversation_id}/end-handoff/
End Handoff
end-handoff 2 params → 200404422500
POST
/v2/conversations/{conversation_id}/attachments/
Upload a file attachment
upload-attachment 2 params body → 201400401404429500

Schemas 43

The contract defines 43 schemas that model the data the API accepts and returns. The most detailed are Conversation (31 properties), Conversation_2 (31 properties), Conversation_3 (7 properties), EmailConversationCreateRequest (7 properties). Each schema is shown below with its type and property counts.

PaginationMetadata
object
1 property
MessageLogsType
string
The type of the message
ConversationMetadata
ConversationsResponseMeta
object
1 property
Conversation
object
31 properties
ConversationMetavariables
object
Object of metavariables and their values active during this conversations
MessageLogs
object
5 properties
ConversationVariables
object
Object of autocapture and global variables and their values last active during this conversations
Message
object
6 properties
MessageCreateRequestContent
The message content
MessageCreateRequest
object
2 properties 2 required
TextContent
object
The content of the text message
2 properties 2 required
LinkContentType
string
The type of the message
ConversationCreateRequestMetadata
Conversation_3
object
7 properties
ConversationCreateRequest
object
3 properties 1 required
MessageList
object
2 properties 2 required
ConversationMessageAuthor
object
Information about the message author
4 properties 1 required
Conversations_endHandoff_Response_200
object
1 property
MessageLogsAuthor
object
Information about the message author
4 properties
TextContentType
string
The type of the message
ConversationPatchRequestMetadata
Conversation_2
object
31 properties
FileContentType
string
The type of the message
ConversationStatus
string
The status of the conversation
EmailConversationCreateResponse
object
1 property
MessageEvents
ErrorsErrorsItems
object
3 properties 2 required
LinkContent
object
The content of a standalone link style messages, such as CSAT
3 properties
ConversationPatchRequest
object
1 property 1 required
EmailConversationCreateRequestMetadata
object
Any metadata associated with the conversation, up to 4 KB. All metadata passed through this field will appear as metavariables in your dashboard.
ConversationCsat
object
Object of customer satisfaction survey data for this conversation
EmailConversationCreateRequest
object
7 properties 3 required
FileContent
object
The content of a file message
4 properties 4 required
ConversationMessageAuthorRole
string
The author's role
MessageLogsAuthorRole
string
The author's role
Conversations_endConversation_Response_200
object
1 property
ConversationsResponse_2
object
3 properties
MessageLogsContent
The message content. The structure varies based on the type field. Supported types: text, link, file.
ConversationsResponse
object
2 properties
Errors
object
1 property 1 required
MessageContent
The message content
AttachmentUploadResponse
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ada-subpackage-conversations-api-openapi.yml Raw ↑

Other APIs Ada publishes across the network.

Ada End Users API
Ada Conversations API
Ada Integrations API
Ada subpackage_channels API
Ada subpackage_deleteChatterData API
Ada subpackage_endUsers API
Ada subpackage_knowledge.subpackage_knowledge/articles API
Ada subpackage_knowledge.subpackage_knowledge/sources API
Ada subpackage_knowledge.subpackage_knowledge/tags API
Ada subpackage_messages API
Ada subpackage_platformIntegrations API
Ada subpackage_webhookManagement API