> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.ada.cx/generative/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server. # Generative ## Docs - [Welcome!](https://developers.ada.cx/generative/home.md) - [Welcome to Ada](https://developers.ada.cx/generative/docs/welcome.md): Introduction - [Key concepts](https://developers.ada.cx/generative/docs/welcome/key-concepts.md) - [Getting started](https://developers.ada.cx/generative/docs/welcome/getting-started.md) - [Create a simple AI Agent](https://developers.ada.cx/generative/docs/welcome/getting-started/create-a-simple-ai-agent.md) - [Enhance your AI Agent with automation](https://developers.ada.cx/generative/docs/welcome/getting-started/enhance-your-ai-agent-with-automation.md) - [Knowledge](https://developers.ada.cx/generative/docs/knowledge.md): Overview - [Agent logic](https://developers.ada.cx/generative/docs/knowledge/agent-logic.md) - [Content generation](https://developers.ada.cx/generative/docs/knowledge/agent-logic/content-generation.md) - [Knowledge setup](https://developers.ada.cx/generative/docs/knowledge/agent-logic/knowledge-setup.md) - [Content ingestion](https://developers.ada.cx/generative/docs/knowledge/content-ingestion.md) - [Knowledge integration](https://developers.ada.cx/generative/docs/knowledge/content-ingestion/knowledge-integration.md) - [Web import](https://developers.ada.cx/generative/docs/knowledge/content-ingestion/web-import.md) - [Article creation](https://developers.ada.cx/generative/docs/knowledge/content-ingestion/article-creation.md) - [Article management](https://developers.ada.cx/generative/docs/knowledge/article-management.md) - [Actions](https://developers.ada.cx/generative/docs/automation/actions.md): Overview - [Action control](https://developers.ada.cx/generative/docs/automation/actions/action-control.md) - [Token configuration](https://developers.ada.cx/generative/docs/automation/actions/token-configuration.md) - [Processes](https://developers.ada.cx/generative/docs/automation/processes.md): Overview - [Process management](https://developers.ada.cx/generative/docs/automation/processes/process-management.md) - [Proactive Conversations](https://developers.ada.cx/generative/docs/automation/proactives.md): Overview - [Proactive messaging](https://developers.ada.cx/generative/docs/automation/proactives/proactive-messaging.md) - [Greetings](https://developers.ada.cx/generative/docs/automation/greetings.md): Overview - [Greeting management](https://developers.ada.cx/generative/docs/automation/greetings/greeting-management.md) - [Persona](https://developers.ada.cx/generative/docs/setup/persona.md): Overview - [Personality setup](https://developers.ada.cx/generative/docs/setup/persona/personality-setup.md) - [Languages](https://developers.ada.cx/generative/docs/setup/languages.md): Overview - [About multilingual support](https://developers.ada.cx/generative/docs/setup/languages/about-multilingual-support.md) - [Multilingual support setup](https://developers.ada.cx/generative/docs/setup/languages/multilingual-support-setup.md) - [Language switching](https://developers.ada.cx/generative/docs/setup/languages/language-switching.md) - [Manual translations in Greeting and Handoffs](https://developers.ada.cx/generative/docs/setup/languages/manual-translations.md) - [Redactions](https://developers.ada.cx/generative/docs/setup/redactions.md): Overview - [Redaction settings](https://developers.ada.cx/generative/docs/setup/redactions/redaction-settings.md) - [Handoffs](https://developers.ada.cx/generative/docs/handoffs.md): Overview - [Handoff management](https://developers.ada.cx/generative/docs/handoffs/handoff-management.md) - [Handoff integrations](https://developers.ada.cx/generative/docs/handoffs/handoff-management/handoff-integrations.md): Overview - [Transcript summaries](https://developers.ada.cx/generative/docs/handoffs/handoff-management/transcript-summaries.md) - [Ada Glass configuration](https://developers.ada.cx/generative/docs/handoffs/salesforce/salesforce-chat/ada-glass-configuration.md) - [Salesforce Chat block](https://developers.ada.cx/generative/docs/handoffs/salesforce/salesforce-chat/salesforce-chat-block.md) - [Salesforce user setup](https://developers.ada.cx/generative/docs/handoffs/salesforce/salesforce-chat/salesforce-user-setup.md) - [Salesforce Action block](https://developers.ada.cx/generative/docs/handoffs/salesforce/salesforce-chat/salesforce-action-block.md) - [Zendesk Chat configuration](https://developers.ada.cx/generative/docs/handoffs/zendesk/zendesk-chat/zendesk-chat-configuration.md) - [Zendesk Chat handoff setup](https://developers.ada.cx/generative/docs/handoffs/zendesk/zendesk-chat/zendesk-chat-handoff-setup.md) - [Zendesk Chat handoff usage](https://developers.ada.cx/generative/docs/handoffs/zendesk/zendesk-chat/zendesk-chat-handoff-usage.md) - [Zendesk Messaging](https://developers.ada.cx/generative/docs/handoffs/zendesk/zendesk-messaging.md) - [Zendesk Support](https://developers.ada.cx/generative/docs/handoffs/zendesk/zendesk-support.md) - [Zendesk Ticketing](https://developers.ada.cx/generative/docs/handoffs/zendesk/zendesk-ticketing.md) - [Channels](https://developers.ada.cx/generative/docs/channels.md): Overview - [Chat](https://developers.ada.cx/generative/docs/channels/chat.md): Overview - [Chat onboarding](https://developers.ada.cx/generative/docs/channels/chat/chat-onboarding.md) - [Appearance settings](https://developers.ada.cx/generative/docs/channels/chat/appearance-settings.md) - [Chat configuration](https://developers.ada.cx/generative/docs/channels/chat/chat-configuration.md) - [Widget embedding](https://developers.ada.cx/generative/docs/channels/chat/widget-embedding.md) - [Domain restrictions](https://developers.ada.cx/generative/docs/channels/chat/domain-restrictions.md) - [Launch Controls](https://developers.ada.cx/generative/docs/channels/chat/launch-controls.md) - [Transcript access](https://developers.ada.cx/generative/docs/channels/chat/transcript-access.md) - [Persistence settings](https://developers.ada.cx/generative/docs/channels/chat/persistence-settings.md) - [Browser support](https://developers.ada.cx/generative/docs/channels/chat/browser-support.md) - [Voice](https://developers.ada.cx/generative/docs/channels/voice.md): Overview - [Voice onboarding](https://developers.ada.cx/generative/docs/channels/voice/voice-onboarding.md) - [Greetings and Handoffs](https://developers.ada.cx/generative/docs/channels/voice/voice-configuration/greetings-and-handoffs.md) - [Voice call capture options](https://developers.ada.cx/generative/docs/channels/voice/voice-configuration/voice-call-capture-options.md) - [Voice AI Agent tools](https://developers.ada.cx/generative/docs/channels/voice/voice-configuration/voice-tools.md) - [CSAT configuration for Voice](https://developers.ada.cx/generative/docs/channels/voice/voice-configuration/voice-csat-configuration.md) - [SMS consent](https://developers.ada.cx/generative/docs/channels/voice/voice-configuration/sms-consent.md) - [Contact center integration](https://developers.ada.cx/generative/docs/channels/voice/contact-center-integration.md) - [Email](https://developers.ada.cx/generative/docs/channels/email.md): Overview - [Email onboarding](https://developers.ada.cx/generative/docs/channels/email/email-onboarding.md) - [Implementation method](https://developers.ada.cx/generative/docs/channels/email/implementation-method.md) - [Appearance settings](https://developers.ada.cx/generative/docs/channels/email/email-configuration/appearance-settings.md) - [BYOD email](https://developers.ada.cx/generative/docs/channels/email/email-configuration/byod-email.md) - [Attachment handling](https://developers.ada.cx/generative/docs/channels/email/email-configuration/attachment-handling.md) - [Email handoffs](https://developers.ada.cx/generative/docs/channels/email/email-configuration/email-handoffs.md) - [CSAT configuration](https://developers.ada.cx/generative/docs/channels/email/email-configuration/csat-configuration.md) - [Launch Controls](https://developers.ada.cx/generative/docs/channels/email/email-configuration/launch-controls.md) - [Deploy your Email AI Agent](https://developers.ada.cx/generative/docs/channels/email/email-deployment.md) - [Social channels](https://developers.ada.cx/generative/docs/channels/social.md): Overview - [Social channel onboarding](https://developers.ada.cx/generative/docs/channels/social/social-channel-onboarding.md) - [Sunshine Conversations setup](https://developers.ada.cx/generative/docs/channels/social/sunshine-conversations-setup.md) - [Zendesk Social integration](https://developers.ada.cx/generative/docs/channels/social/zendesk-social-integration.md) - [Third-party channels](https://developers.ada.cx/generative/docs/channels/third-party.md): Overview - [Zendesk SDK Deployment](https://developers.ada.cx/generative/docs/channels/third-party/zendesk-sdk-deployment.md) - [Sunshine Conversations Web Messenger](https://developers.ada.cx/generative/docs/channels/third-party/sunshine-web-messenger.md) - [Testing](https://developers.ada.cx/generative/docs/monitoring/testing.md): Overview - [AI Agent testing](https://developers.ada.cx/generative/docs/monitoring/testing/ai-agent-testing.md) - [Conversations](https://developers.ada.cx/generative/docs/monitoring/conversations.md): Overview - [Resolution rate optimization](https://developers.ada.cx/generative/docs/monitoring/conversations/resolution-rate-optimization.md) - [Response training](https://developers.ada.cx/generative/docs/monitoring/conversations/response-training.md) - [Data export](https://developers.ada.cx/generative/docs/monitoring/conversations/data-export.md) - [Coaching](https://developers.ada.cx/generative/docs/monitoring/coaching.md): Overview - [Coaching tools](https://developers.ada.cx/generative/docs/monitoring/coaching/coaching-tools.md) - [Topics](https://developers.ada.cx/generative/docs/monitoring/performance/topics.md): Overview - [Topic analysis](https://developers.ada.cx/generative/docs/monitoring/performance/topics/topic-analysis.md) - [Reports](https://developers.ada.cx/generative/docs/monitoring/performance/reports.md): Overview - [Performance reports](https://developers.ada.cx/generative/docs/monitoring/performance/reports/performance-reports.md) - [CSAT](https://developers.ada.cx/generative/docs/monitoring/performance/csat.md): Overview - [CSAT configuration](https://developers.ada.cx/generative/docs/monitoring/performance/csat/csat-configuration.md) - [Personalization data: Collection and use](https://developers.ada.cx/generative/docs/other-features/personalization-data.md) - [Custom Instructions](https://developers.ada.cx/generative/docs/other-features/custom-instructions.md) - [Team access](https://developers.ada.cx/generative/docs/other-features/team-access.md): Overview - [My team](https://developers.ada.cx/generative/docs/other-features/team-access/my-team.md) - [SSO](https://developers.ada.cx/generative/docs/other-features/team-access/sso.md) - [Profile](https://developers.ada.cx/generative/docs/other-features/team-access/profile.md) - [API Overview](https://developers.ada.cx/generative/reference/introduction/overview.md) - [Authentication](https://developers.ada.cx/generative/reference/introduction/authentication.md) - [Versioning](https://developers.ada.cx/generative/reference/introduction/versioning.md) - [Limits](https://developers.ada.cx/generative/reference/introduction/limits.md) - [Pagination](https://developers.ada.cx/generative/reference/introduction/pagination.md) - [Errors](https://developers.ada.cx/generative/reference/introduction/errors.md) - [Webhooks](https://developers.ada.cx/generative/reference/introduction/webhooks.md) - [Migrate to v2 APIs](https://developers.ada.cx/generative/reference/introduction/migrate-to-v-2.md) - [Changelog](https://developers.ada.cx/generative/reference/introduction/changelog/llms.txt) - [Overview](https://developers.ada.cx/generative/reference/knowledge/overview.md): Knowledge API - [Sources](https://developers.ada.cx/generative/reference/knowledge/sources.md) - [Articles](https://developers.ada.cx/generative/reference/knowledge/articles.md) - [Tags](https://developers.ada.cx/generative/reference/knowledge/tags.md) - [Overview](https://developers.ada.cx/generative/reference/end-users/overview.md): End Users API - [Getting started](https://developers.ada.cx/generative/reference/end-users/getting-started.md) - [Overview](https://developers.ada.cx/generative/reference/integrations/overview.md): Integrations API - [Getting started](https://developers.ada.cx/generative/reference/integrations/getting-started.md) - [Overview](https://developers.ada.cx/generative/reference/email-conversations/overview.md): Email Conversations API - [Getting started](https://developers.ada.cx/generative/reference/email-conversations/getting-started.md) - [Overview](https://developers.ada.cx/generative/reference/conversations/eap-overview.md): Conversations API EAP - [Getting started](https://developers.ada.cx/generative/reference/conversations/getting-started.md) - [Overview](https://developers.ada.cx/generative/reference/data-compliance/overview.md) - [Overview](https://developers.ada.cx/generative/reference/data-export/overview.md) - [Getting started](https://developers.ada.cx/generative/reference/data-export/getting-started.md) - [Conversation object](https://developers.ada.cx/generative/data-export-conversation-object.md) - [Message object](https://developers.ada.cx/generative/data-export-message-object.md) - [Overview](https://developers.ada.cx/generative/reference/data-export/data-export-v1-4/overview.md) - [Conversation object](https://developers.ada.cx/generative/reference/data-export/data-export-v1-4/conversations.md) - [Message object](https://developers.ada.cx/generative/reference/data-export/data-export-v1-4/messages.md) - [Overview](https://developers.ada.cx/generative/chat/introduction/overview.md) - [Overview](https://developers.ada.cx/generative/chat/web/overview.md) - [Getting started](https://developers.ada.cx/generative/chat/web/getting-started.md) - [SDK API Reference](https://developers.ada.cx/generative/chat/web/sdk-api-reference.md) - [Overview](https://developers.ada.cx/generative/chat/ios/overview.md) - [Getting started](https://developers.ada.cx/generative/chat/ios/getting-started.md) - [iOS SDK reference](https://developers.ada.cx/generative/chat/ios/sdk-api-reference.md) - [Overview](https://developers.ada.cx/generative/chat/android/overview.md) - [Getting started](https://developers.ada.cx/generative/chat/android/getting-started.md) - [SDK API Reference](https://developers.ada.cx/generative/chat/android/sdk-api-reference.md) - [Overview](https://developers.ada.cx/generative/chat/react-native/overview.md) - [Getting started](https://developers.ada.cx/generative/chat/react-native/getting-started.md) - [SDK API Reference](https://developers.ada.cx/generative/chat/react-native/sdk-api-reference.md) ## API Docs - [Get knowledge sources](https://developers.ada.cx/generative/reference/knowledge/sources/list.md): Knowledge > Knowledge > Sources - [Create a knowledge source](https://developers.ada.cx/generative/reference/knowledge/sources/create.md): Knowledge > Knowledge > Sources - [Delete a knowledge source](https://developers.ada.cx/generative/reference/knowledge/sources/delete.md): Knowledge > Knowledge > Sources - [Update a knowledge source](https://developers.ada.cx/generative/reference/knowledge/sources/update.md): Knowledge > Knowledge > Sources - [Get knowledge articles](https://developers.ada.cx/generative/reference/knowledge/articles/list.md): Knowledge > Knowledge > Articles - [Delete multiple articles](https://developers.ada.cx/generative/reference/knowledge/articles/delete.md): Knowledge > Knowledge > Articles - [Get a single knowledge article](https://developers.ada.cx/generative/reference/knowledge/articles/get.md): Knowledge > Knowledge > Articles - [Delete a single article](https://developers.ada.cx/generative/reference/knowledge/articles/delete-by-id.md): Knowledge > Knowledge > Articles - [Upsert multiple articles](https://developers.ada.cx/generative/reference/knowledge/articles/bulk-upsert.md): Knowledge > Knowledge > Articles - [Get article tags](https://developers.ada.cx/generative/reference/knowledge/tags/list.md): Knowledge > Knowledge > Tags - [Delete a single article tag](https://developers.ada.cx/generative/reference/knowledge/tags/delete.md): Knowledge > Knowledge > Tags - [Upsert multiple tags](https://developers.ada.cx/generative/reference/knowledge/tags/upsert-multiple.md): Knowledge > Knowledge > Tags - [Get an end user](https://developers.ada.cx/generative/reference/end-users/get-end-user-by-id.md): Knowledge > End Users > End Users - [Update an end user](https://developers.ada.cx/generative/reference/end-users/patch-end-user-by-id.md): Knowledge > End Users > End Users - [Get multiple end users](https://developers.ada.cx/generative/reference/end-users/get-end-users.md): Knowledge > End Users > End Users - [Webhook: End user created](https://developers.ada.cx/generative/reference/end-users/end-user-created-webhook.md): Knowledge > End Users > End Users - [Webhook: End user updated](https://developers.ada.cx/generative/reference/end-users/end-user-updated-webhook.md): Knowledge > End Users > End Users - [List integrations](https://developers.ada.cx/generative/reference/integrations/get-platform-integrations.md): Knowledge > Integrations > Integrations - [Create an integration](https://developers.ada.cx/generative/reference/integrations/create-platform-integration.md): Knowledge > Integrations > Integrations - [Update an integration](https://developers.ada.cx/generative/reference/integrations/update-single-platform-integration.md): Knowledge > Integrations > Integrations - [Get an installation](https://developers.ada.cx/generative/reference/integrations/get-platform-integration-installation-self.md): Knowledge > Integrations > Integrations - [Update installation status](https://developers.ada.cx/generative/reference/integrations/update-platform-integration-installation.md): Knowledge > Integrations > Integrations - [Start a conversation over Ada's email channel](https://developers.ada.cx/generative/reference/email-conversations/create-email-conversation.md): Knowledge > Email Conversations > Conversations - [Get a list of channels](https://developers.ada.cx/generative/reference/conversations/get-channels.md): Conversations > Conversations (EAP) > Channels - [Create a new channel](https://developers.ada.cx/generative/reference/conversations/create-channel.md): Conversations > Conversations (EAP) > Channels - [Create a new conversation](https://developers.ada.cx/generative/reference/conversations/create-conversation.md): Conversations > Conversations (EAP) > Conversations - [Get a conversation](https://developers.ada.cx/generative/reference/conversations/get-conversation-by-id.md): Conversations > Conversations (EAP) > Conversations - [Create a new message](https://developers.ada.cx/generative/reference/conversations/create-message.md): Conversations > Conversations (EAP) > Conversations - [End a conversation](https://developers.ada.cx/generative/reference/conversations/end-conversation.md): Conversations > Conversations (EAP) > Conversations - [Webhook: Conversation created](https://developers.ada.cx/generative/reference/conversations/conversation-created-webhook.md): Conversations > Conversations (EAP) > Webhooks - [Webhook: Conversation message](https://developers.ada.cx/generative/reference/conversations/conversation-message-webhook.md): Conversations > Conversations (EAP) > Webhooks - [Webhook: Conversation ended](https://developers.ada.cx/generative/reference/conversations/conversation-ended-webhook.md): Conversations > Conversations (EAP) > Webhooks - [Delete all data associated with a chatter's email address](https://developers.ada.cx/generative/reference/data-compliance/delete-chatter-data/delete-all-data-associated-with-a-chatters-email-address.md): Data Compliance > Data Compliance > Delete Chatter Data - [Return conversations matching the parameters](https://developers.ada.cx/generative/data-export-conversation-object/get-conversations.md): Data Export > Data Export > Conversations - [Return messages matching the parameters](https://developers.ada.cx/generative/data-export-message-object/get-messages.md): Data Export > Data Export > Messages - [Return conversations matching the parameters](https://developers.ada.cx/generative/reference/data-export/data-export-v1-4/conversations/return-conversations-matching-the-parameters.md): Data Export (v1.4) > Data Export (v1.4) > Conversations - [Return messages matching the parameters](https://developers.ada.cx/generative/reference/data-export/data-export-v1-4/messages/return-messages-matching-the-parameters.md): Data Export (v1.4) > Data Export (v1.4) > Messages ## OpenAPI Specification - [OpenAPI JSON](https://developers.ada.cx/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format - [OpenAPI YAML](https://developers.ada.cx/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format