# PolyAI Platform

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://poly-ai.ferndocs.com/_mcp/server

## Docs

- [PolyAI documentation](https://poly-ai.ferndocs.com/agent-studio/get-started/home.md): Build agents ready for real customer conversations.
- [Platform overview](https://poly-ai.ferndocs.com/agent-studio/get-started/platform-overview.md): PolyAI's Agentic Dialog Platform is an enterprise platform for building voice and chat agents.
- [Agent Studio](https://poly-ai.ferndocs.com/agent-studio/get-started/agent-studio.md): Visual interface for building, deploying, and monitoring PolyAI voice agents.
- [Quickstart](https://poly-ai.ferndocs.com/agent-studio/get-started/quickstart.md): Create an account, build your first agent, and deploy it in minutes.
- [Meet the new Agent Studio](https://poly-ai.ferndocs.com/agent-studio/get-started/whats-new.md): Agent Studio got a new layout on 24 June 2026. Watch the tour, see what moved, and find your favorite features in their new homes.
- [Studio Assistant](https://poly-ai.ferndocs.com/agent-studio/studio-assistant/overview.md): Build, test, debug, and analyze your agent in natural language from the Agent Studio home screen.
- [Prompting guide](https://poly-ai.ferndocs.com/agent-studio/studio-assistant/prompting-guide.md): Practical patterns for getting consistently good results from Studio Assistant, with real prompt examples for building, testing, asking, and analyzing.
- [Smart Analyst](https://poly-ai.ferndocs.com/agent-studio/studio-assistant/smart-analyst.md): Ask natural-language questions about your agent's conversations from inside Studio Assistant.
- [Usage and limits](https://poly-ai.ferndocs.com/agent-studio/studio-assistant/usage-and-limits.md): How Studio Assistant usage is tracked and what to do when you hit your limit.
- [KPIs](https://poly-ai.ferndocs.com/agent-studio/analytics/kp-is.md): Define and manage custom metrics for your agent.
- [Post-call reporting](https://poly-ai.ferndocs.com/agent-studio/analytics/post-call-reporting.md): Capture real-time metrics during the call and run LLM-based extraction queries after the call to produce structured reporting data.
- [PolyScore](https://poly-ai.ferndocs.com/agent-studio/analytics/poly-score.md): Automated conversation quality scoring for voice calls.
- [Surveys](https://poly-ai.ferndocs.com/agent-studio/analytics/surveys.md): Measure customer satisfaction with in-call voice CSAT surveys.
- [Conversations](https://poly-ai.ferndocs.com/agent-studio/conversations/overview.md): Inspect individual conversations to debug agent behavior and audit call quality.
- [Review](https://poly-ai.ferndocs.com/agent-studio/conversations/review.md): Browse, filter, and inspect voice and webchat conversations from a single workspace.
- [Views](https://poly-ai.ferndocs.com/agent-studio/conversations/views.md): Save filter and column combinations as private pinned tabs to make conversation review repeatable.
- [Annotations](https://poly-ai.ferndocs.com/agent-studio/conversations/annotations.md): Flag good and bad agent responses, mark factual errors, and capture transcript and Knowledge gaps during review.
- [Diagnosis](https://poly-ai.ferndocs.com/agent-studio/conversations/diagnosis.md): Toggle diagnostic layers to inspect tool calls, flows, latency, and topic citations on the Transcription tab.
- [Dashboards](https://poly-ai.ferndocs.com/agent-studio/custom-dashboards/overview.md): Analyze agent performance with dashboards.
- [Standard](https://poly-ai.ferndocs.com/agent-studio/custom-dashboards/standard.md): Track call volumes, containment, and performance.
- [Safety](https://poly-ai.ferndocs.com/agent-studio/custom-dashboards/safety.md): Monitor risky conversations and content filtering.
- [Custom](https://poly-ai.ferndocs.com/agent-studio/custom-dashboards/custom.md): Enterprise dashboards tailored to your business KPIs.
- [Behavior](https://poly-ai.ferndocs.com/agent-studio/behavior/overview.md): Set and edit your agent's global rules, model, personality, and fixed greeting line.
- [Agent](https://poly-ai.ferndocs.com/agent-studio/behavior/general/personality-and-role.md): Define your agent's personality and role.
- [Rules](https://poly-ai.ferndocs.com/agent-studio/behavior/general/behavior.md): Set global rules to control your agent behavior, tone, and compliance.
- [Multi-language](https://poly-ai.ferndocs.com/agent-studio/behavior/language/multi-language.md): Configure your agent to handle conversations in multiple languages from a single project.
- [Language coverage](https://poly-ai.ferndocs.com/agent-studio/behavior/language/language-coverage.md): Languages and models supported across LLM, ASR, and TTS on the PolyAI platform.
- [Translations](https://poly-ai.ferndocs.com/agent-studio/behavior/language/translations.md): Manually override auto-translated content for multilingual agents.
- [Guardrails](https://poly-ai.ferndocs.com/agent-studio/behavior/guardrails/guardrails.md): Platform safety guardrails that protect your agent in production, with observability in conversation transcripts.
- [Safety filters](https://poly-ai.ferndocs.com/agent-studio/behavior/guardrails/safety-filters.md): Per-channel content filters that classify user input and agent output across hate, sexual, violence, and self-harm – and always-on jailbreak detection.
- [Model](https://poly-ai.ferndocs.com/agent-studio/behavior/models/overview.md): Choose which LLM powers your agent – including PolyAI Raven, our proprietary model family built for conversational AI.
- [Raven](https://poly-ai.ferndocs.com/agent-studio/behavior/models/raven.md): PolyAI's proprietary LLM family, built for customer service across voice and chat.
- [Bring your own model (BYOM)](https://poly-ai.ferndocs.com/agent-studio/behavior/models/bring-your-own-model-byom.md): Connect your own LLM endpoint to PolyAI.
- [FAQs](https://poly-ai.ferndocs.com/agent-studio/knowledge/fa-qs/fa-qs.md): Create curated FAQ topics with sample questions, answers, and actions to handle common caller requests.
- [RAG](https://poly-ai.ferndocs.com/agent-studio/knowledge/fa-qs/rag.md): How retrieval-augmented generation powers topic matching.
- [Actions](https://poly-ai.ferndocs.com/agent-studio/knowledge/fa-qs/actions/overview.md): Guide to setting up actions for SMS, functions, and handoffs
- [Send SMS](https://poly-ai.ferndocs.com/agent-studio/knowledge/fa-qs/actions/send-sms.md): Trigger an SMS directly from Managed Topic actions
- [Invoke tool](https://poly-ai.ferndocs.com/agent-studio/knowledge/fa-qs/actions/invoke-tool.md): Invoke a tool (Python function) from a managed-topic action to extend your agent with custom logic.
- [Handoff](https://poly-ai.ferndocs.com/agent-studio/knowledge/fa-qs/actions/handoff.md): Trigger call handoffs from Managed Topic actions
- [Sources](https://poly-ai.ferndocs.com/agent-studio/knowledge/sources/sources.md): Manage multiple external knowledge sources (sources) to inform your agent's responses.
- [Variants](https://poly-ai.ferndocs.com/agent-studio/knowledge/variants/overview.md): Manage multi-site configurations for a single agent.
- [CSV imports](https://poly-ai.ferndocs.com/agent-studio/knowledge/variants/csv-imports.md): Bulk import and update variants using CSV files
- [Flows](https://poly-ai.ferndocs.com/agent-studio/flows/overview.md): Use flows to guide callers through structured, multi-step processes with validation and branching logic.
- [Triggering flows](https://poly-ai.ferndocs.com/agent-studio/flows/triggering-flows.md): Start flows from FAQs, global functions, or transition functions using conv.goto_flow().
- [Example flow](https://poly-ai.ferndocs.com/agent-studio/flows/example-flow.md): A complete reservation confirmation flow showing prompts, transitions, and ASR biasing patterns.
- [No-code flows](https://poly-ai.ferndocs.com/agent-studio/flows/no-code/overview.md): Build conversational workflows visually using Default steps and entity extraction without Python.
- [Entities](https://poly-ai.ferndocs.com/agent-studio/flows/no-code/entities.md): Define and validate structured data types like names, dates, and phone numbers in flow steps.
- [Quickstart](https://poly-ai.ferndocs.com/agent-studio/flows/no-code/quickstart.md): Build your first no-code flow step by step with Default steps and routing.
- [Advanced steps](https://poly-ai.ferndocs.com/agent-studio/flows/no-code/advanced-steps.md): Enable ASR biasing, DTMF collection, and function references in flow steps for precise control.
- [Tools](https://poly-ai.ferndocs.com/agent-studio/tools/overview.md): Add custom logic and API integrations using Python functions.
- [Create tool](https://poly-ai.ferndocs.com/agent-studio/tools/create-tool.md): Write Python functions with parameters and return values to integrate APIs and business logic.
- [Using tools](https://poly-ai.ferndocs.com/agent-studio/tools/using-tools.md): Attach functions to FAQs actions to call APIs and perform logic when topics match.
- [Webchat overview](https://poly-ai.ferndocs.com/agent-studio/tools/functions/webchat-overview.md): Embed PolyAI's webchat experience in your web and mobile apps.
- [Chat configuration](https://poly-ai.ferndocs.com/agent-studio/tools/functions/chat-configuration.md): Configure the webchat widget's appearance and behavior.
- [Multichannel](https://poly-ai.ferndocs.com/agent-studio/tools/functions/multichannel.md): Deliver consistent conversations across voice, chat, and messaging.
- [Tool classes](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/classes.md): Use Conversation, Voice, and utility classes to manage state and configure TTS providers in functions.
- [Conversation](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/object.md): The Conversation object, its attributes, and methods.
- [Conversation utilities](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/utilities.md): Access secrets and helper methods for extracting addresses and other structured data from conv.utils.
- [Conversation API client](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/api.md): Call configured APIs from functions using conv.api with automatic environment and auth handling.
- [Conversation log](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/log.md): Write structured log entries visible in Conversation Review diagnostics using conv.log methods.
- [ASR biasing from functions](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/asr-biasing.md): Set and clear speech recognition biasing at runtime using conv.set_asr_biasing() for dynamic vocabulary.
- [Disable knowledge topics from functions](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/disable-kb-topics.md): Exclude specific FAQs from RAG retrieval at runtime using conv.disable_kb_topics() based on conversation context.
- [History](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/history.md): Access conversation turn history as UserInput and AgentResponse objects from conv.history.
- [Voice](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/voice.md): Configure TTS providers like ElevenLabs and Cartesia programmatically using voice classes.
- [Agent memory](https://poly-ai.ferndocs.com/agent-studio/tools/classes-and-objects/agent-memory.md): Remember information about returning callers across separate conversations using persistent key-value storage.
- [Start tool](https://poly-ai.ferndocs.com/agent-studio/tools/start-tool.md): Initialize conversation state, read SIP headers, and set variant routing before the greeting plays.
- [End tool](https://poly-ai.ferndocs.com/agent-studio/tools/end-tool.md): Run post-call processing asynchronously after a conversation ends.
- [Return values](https://poly-ai.ferndocs.com/agent-studio/tools/return-values.md): Control agent behavior with strings, utterances, handoffs, and other return types from functions.
- [Variables](https://poly-ai.ferndocs.com/agent-studio/tools/variables.md): Store and access data across conversation turns using the conv.state object in functions.
- [Delay control](https://poly-ai.ferndocs.com/agent-studio/tools/delay-control.md): Play interim filler phrases while functions execute to keep callers engaged and avoid silence.
- [Libraries](https://poly-ai.ferndocs.com/agent-studio/tools/libraries.md): Standard library and pre-installed packages available to functions, including requests, jsonschema, and urllib3.
- [Testing](https://poly-ai.ferndocs.com/agent-studio/testing/overview.md): Validate your agent before and after going live with simulation tests and A/B experiments.
- [Simulation tests](https://poly-ai.ferndocs.com/agent-studio/testing/simulation-tests.md): Author scenario-based tests with assertions, tags, and system actions.
- [Test suite](https://poly-ai.ferndocs.com/agent-studio/testing/test-suite.md): Save conversations as test cases and re-run them to check for regressions.
- [Run and review](https://poly-ai.ferndocs.com/agent-studio/testing/run-and-review.md): Execute simulation tests, inspect results, and organize tests into sets.
- [A/B testing](https://poly-ai.ferndocs.com/agent-studio/testing/a-b-testing.md): Run two live agent versions in parallel, split real traffic between them, and pick a winner based on real performance data.
- [Automate with API](https://poly-ai.ferndocs.com/agent-studio/testing/automate-with-api.md): Gate deployments on simulation test results using the Agents API.
- [Real-time config](https://poly-ai.ferndocs.com/agent-studio/real-time-config/overview.md): Let non-technical managers update agent settings without publishing new versions using structured configuration forms.
- [Voice](https://poly-ai.ferndocs.com/agent-studio/voice/overview.md): Configure how your agent sounds and how it listens.
- [Voice settings](https://poly-ai.ferndocs.com/agent-studio/voice/settings.md): Configure your agent's voice, greeting, disclaimer, and style prompt.
- [Handoff](https://poly-ai.ferndocs.com/agent-studio/voice/handoffs.md): Set up handoff destinations to transfer users to human agents during conversations.
- [Message templates](https://poly-ai.ferndocs.com/agent-studio/voice/message-templates.md): Send SMS messages from your agent using Twilio for confirmations, links, and follow-ups
- [Number availability & compliance](https://poly-ai.ferndocs.com/agent-studio/voice/number-availability.md): Country-by-country Twilio number availability, throughput limits, lead times, and regulatory links for 2-way SMS.
- [Audio library](https://poly-ai.ferndocs.com/agent-studio/voice/audio-library.md): Manage cached audio files to reduce voice latency.
- [Voice library](https://poly-ai.ferndocs.com/agent-studio/voice/voice-design/voice-library.md): Browse, preview, and select voices for your agent.
- [Choosing a good voice](https://poly-ai.ferndocs.com/agent-studio/voice/voice-design/choosing-a-good-voice.md): Guidelines for selecting the right voice for your agent.
- [Use more than one voice](https://poly-ai.ferndocs.com/agent-studio/voice/voice-design/multi-voice.md): Assign multiple voices to simulate a team of agents.
- [Add a voice](https://poly-ai.ferndocs.com/agent-studio/voice/voice-design/add-a-voice.md)
- [Custom voice](https://poly-ai.ferndocs.com/agent-studio/voice/voice-design/custom-voice.md): Commission a brand-exclusive custom voice for enterprise accounts.
- [Numbers](https://poly-ai.ferndocs.com/agent-studio/voice/numbers/overview.md): Connect phone numbers to your agent using PolyAI, Twilio, or outbound calling
- [Buy a number from PolyAI](https://poly-ai.ferndocs.com/agent-studio/voice/numbers/buy-a-number-from-poly-ai.md): Purchase phone numbers directly in Agent Studio.
- [Phone numbers](https://poly-ai.ferndocs.com/agent-studio/voice/numbers/phone-numbers.md): Add, manage, and track phone numbers used by your agent.
- [Outbound calling](https://poly-ai.ferndocs.com/agent-studio/voice/numbers/outbound-calling.md): Configure outbound calls for appointment reminders, follow-ups, and notifications
- [Twilio](https://poly-ai.ferndocs.com/agent-studio/voice/numbers/twilio/overview.md): Connect your Twilio account to use existing phone numbers and SMS with PolyAI
- [Phone number integration](https://poly-ai.ferndocs.com/agent-studio/voice/numbers/twilio/phone-number-integration.md): Integrate a Twilio phone number with PolyAI Agent Studio
- [Handoff integration](https://poly-ai.ferndocs.com/agent-studio/voice/numbers/twilio/handoff-integration.md): Set up handoff destinations with Twilio
- [Advanced voice settings](https://poly-ai.ferndocs.com/agent-studio/voice/advanced-settings.md): Configure model selection, barge-in, filler phrases, safety filters, keyphrases, transcript corrections, and pronunciation for voice agents.
- [Messaging](https://poly-ai.ferndocs.com/agent-studio/messaging/overview.md): Deploy a webchat version of your agent alongside voice.
- [iOS SDK](https://poly-ai.ferndocs.com/agent-studio/messaging/i-os-sdk.md): Embed a PolyAI messaging agent natively in your iOS app with a headless Swift library.
- [Android SDK](https://poly-ai.ferndocs.com/agent-studio/messaging/android-sdk.md): Embed a PolyAI messaging agent natively in your Android app with a headless Kotlin library.
- [Multichannel agents](https://poly-ai.ferndocs.com/agent-studio/messaging/multichannel-agents.md): Build agents that work across voice and webchat from a single project.
- [Configuration](https://poly-ai.ferndocs.com/agent-studio/messaging/advanced/configuration.md): Configure LLM, greeting, and safety filters for chat.
- [Integrations](https://poly-ai.ferndocs.com/agent-studio/integrations/overview.md): Connect PolyAI to your existing platforms: telephony, CRM, payments, and knowledge systems.
- [MCP integrations](https://poly-ai.ferndocs.com/agent-studio/integrations/mcp-integrations.md): Connect your agent to external MCP servers so it can call their tools during conversations.
- [Chat handoff integrations](https://poly-ai.ferndocs.com/agent-studio/integrations/chat-handoffs/overview.md): Hand off webchat and SMS conversations from your PolyAI agent to a live agent in your CCaaS or CRM.
- [Salesforce chat handoff](https://poly-ai.ferndocs.com/agent-studio/integrations/chat-handoffs/salesforce.md): Hand off a webchat or SMS conversation from PolyAI to a Salesforce Service Cloud Messaging agent.
- [Zendesk chat handoff](https://poly-ai.ferndocs.com/agent-studio/integrations/chat-handoffs/zendesk.md): Hand off a webchat or SMS conversation from PolyAI to a Zendesk Messaging agent.
- [NICE CXone chat handoff](https://poly-ai.ferndocs.com/agent-studio/integrations/chat-handoffs/nice-c-xone.md): Hand off a webchat or SMS conversation from PolyAI to a NICE CXone Digital agent.
- [Amazon Connect chat handoff](https://poly-ai.ferndocs.com/agent-studio/integrations/chat-handoffs/amazon-connect.md): Hand off a webchat or SMS conversation from PolyAI to an Amazon Connect chat agent.
- [Webex by Cisco chat handoff](https://poly-ai.ferndocs.com/agent-studio/integrations/chat-handoffs/webex-by-cisco.md): Hand off a webchat or SMS conversation from PolyAI to a Webex Contact Center agent.
- [Genesys Cloud](https://poly-ai.ferndocs.com/agent-studio/integrations/chat-handoffs/genesys-cloud.md): Connect a Genesys Cloud org to PolyAI Agent Studio via Open Messaging, with handoff routed to an ACD queue.
- [Deployments](https://poly-ai.ferndocs.com/agent-studio/deployments/overview.md): Ship safely: branch, promote, A/B test, and roll back from one timeline.
- [Compare versions](https://poly-ai.ferndocs.com/agent-studio/deployments/compare-versions.md): Use side-by-side diffs to compare versions and track changes across your entire project.
- [Project history](https://poly-ai.ferndocs.com/agent-studio/deployments/project-history.md): Project history has been sunset. Use version history on the Deployments page instead.
- [Widgets](https://poly-ai.ferndocs.com/agent-studio/widgets/overview.md): One unified surface for embedding PolyAI on your website. Pick Phone or Chat as the widget type.
- [Web Calling](https://poly-ai.ferndocs.com/agent-studio/widgets/web-calling.md): A voice widget your visitors click to talk to your agent. End-to-end browser audio, no phone numbers.
- [Configure widget](https://poly-ai.ferndocs.com/agent-studio/widgets/configure-widget.md): Brand your widget, write the copy, set up consent. One editor for Phone and Chat.
- [Install on your site](https://poly-ai.ferndocs.com/agent-studio/widgets/install-on-your-site.md): Embed your widget on your website. Single script tag, live in minutes.
- [Test your widget](https://poly-ai.ferndocs.com/agent-studio/widgets/test-your-widget.md): Open a hosted preview of your Phone widget and place an end-to-end call before embedding.
- [Share your agent](https://poly-ai.ferndocs.com/agent-studio/widgets/share-your-agent.md): Three ways to get your voice agent in front of someone: a link, a widget on your site, or a custom trigger via the Web Calling JavaScript API.
- [Troubleshooting](https://poly-ai.ferndocs.com/agent-studio/widgets/troubleshooting.md): Diagnose widget issues: rendering, microphone, network, CSP, and call-quality problems.
- [Account](https://poly-ai.ferndocs.com/agent-studio/account/account.md): Account settings: safety filters, defaults, and admin controls.
- [User management](https://poly-ai.ferndocs.com/agent-studio/account/user-management/overview.md): Manage team access and permissions for your PolyAI account.
- [Role permissions](https://poly-ai.ferndocs.com/agent-studio/account/user-management/role-permissions.md): Reference guide for granular permissions and role-based access control.
- [How to invite users](https://poly-ai.ferndocs.com/agent-studio/account/user-management/how-to-invite-users.md): Add team members to your account with role-based permissions.
- [API keys](https://poly-ai.ferndocs.com/agent-studio/account/api-keys.md): Create and manage API keys for accessing PolyAI's external APIs.
- [Recordings and transcripts](https://poly-ai.ferndocs.com/agent-studio/account/call-data/recordings-and-transcripts.md): Access call recordings, transcripts, and metadata for compliance, QA, and performance analysis.
- [Studio transcripts](https://poly-ai.ferndocs.com/agent-studio/account/call-data/studio-transcripts.md): Access conversation transcripts and recordings directly in Agent Studio for compliance, QA, and analysis.
- [Handoff States](https://poly-ai.ferndocs.com/agent-studio/account/call-data/api-and-export/handoff-states.md): Retrieve the handoff state and context written by your agent when a conversation transitions to a live agent.
- [List conversations](https://poly-ai.ferndocs.com/agent-studio/account/call-data/api-and-export/list-conversations.md): Retrieve conversation transcripts and metadata programmatically using the Conversations API.
- [AWS S3 integration](https://poly-ai.ferndocs.com/agent-studio/account/call-data/api-and-export/aws-s-3-integration.md): Automatically sync call recordings and transcripts to your S3 bucket for long-term storage and compliance.
- [Compliance](https://poly-ai.ferndocs.com/agent-studio/account/legal/compliance.md): Our global standards and certifications for data security and privacy.
- [Training data](https://poly-ai.ferndocs.com/agent-studio/account/legal/training-data.md): Information on the datasets used for our proprietary LLM, PolyAI Raven
- [PolyAcademy: Learn to build voice agents](https://poly-ai.ferndocs.com/academy/poly-academy/poly-academy.md): Free, hands-on tutorials for building voice agents in Agent Studio. Go from beginner to expert at your own pace – no coding required to start.
- [Home](https://poly-ai.ferndocs.com/academy/poly-academy/home.md): Learn to build, configure, and maintain production-ready voice agents through hands-on guides across three skill levels.
- [Design principles](https://poly-ai.ferndocs.com/academy/poly-academy/design-principles.md): Core priorities and practical guidelines for building agents that work well.
- [Get started](https://poly-ai.ferndocs.com/academy/poly-academy/get-started.md): Build your first working agent – from blank project to testable voice assistant in about 30 minutes.
- [Recipes](https://poly-ai.ferndocs.com/academy/recipes/recipes.md): Copy-paste patterns for common voice agent workflows — tested, annotated, and ready to adapt.
- [Already have an agent?](https://poly-ai.ferndocs.com/academy/maintain/home.md): Quick-reference maintenance guides for keeping your live agent running smoothly.
- [Maintaining FAQs](https://poly-ai.ferndocs.com/academy/maintain/maintaining-fa-qs.md): Quickly edit, add, or bulk-update FAQs – the agent's FAQ and knowledge.
- [Maintaining Sources](https://poly-ai.ferndocs.com/academy/maintain/maintaining-sources.md): Sync and manage external knowledge sources – websites, files, and integrations – to keep content current.
- [Voice and audio updates](https://poly-ai.ferndocs.com/academy/maintain/voice-and-audio-updates.md): Change voice, fix pronunciations, adjust latency, and manage cached audio for optimal voice quality.
- [Tool maintenance](https://poly-ai.ferndocs.com/academy/maintain/tool-maintenance.md): Update tool code (Python functions), debug errors using logs, manage credentials, and fix integration issues.
- [Multi-language updates](https://poly-ai.ferndocs.com/academy/maintain/multi-language-updates.md): Add languages, update language-specific knowledge and voices, and manage pronunciation rules per language.
- [Performance monitoring](https://poly-ai.ferndocs.com/academy/maintain/performance-monitoring.md): Track latency, containment, and ASR accuracy – use dashboards and Smart Analyst for deep insights.
- [Version management](https://poly-ai.ferndocs.com/academy/maintain/version-management.md): Publish, promote through environments, compare versions, and rollback safely when needed.
- [Health checks](https://poly-ai.ferndocs.com/academy/maintain/health-checks.md): Daily, weekly, and monthly monitoring routines to keep your live agent running smoothly and reliably.
- [Routing and handoffs](https://poly-ai.ferndocs.com/academy/maintain/routing-and-handoffs.md): Update handoff destinations, manage SIP routing, and test transfers without disrupting live traffic."
- [Temporary closures](https://poly-ai.ferndocs.com/academy/maintain/temporary-closures.md): Close your agent early or play a closure message for same-day schedule changes.
- [QA and analytics](https://poly-ai.ferndocs.com/academy/maintain/qa-and-analytics.md): Review conversations, analyze dashboards, and use Smart Analyst for insights across hundreds of calls.
- [Common issues](https://poly-ai.ferndocs.com/academy/maintain/common-issues.md): Diagnose and fix the most frequent agent issues with step-by-step troubleshooting.
- [Improve your agent after a real call](https://poly-ai.ferndocs.com/academy/maintain/iterate-after-a-call.md): Read the transcript, find the failure, ask Studio Assistant to fix it. The loop that gets the agent from working to actually good.
- [Glossary](https://poly-ai.ferndocs.com/academy/glossary/overview.md): Definitions of key terms used in the PolyAI Agent Studio.
- [Architecture overview](https://poly-ai.ferndocs.com/academy/glossary/architecture-overview.md): Understand how PolyAI agents process conversations from start to finish.
- [Conversation flow](https://poly-ai.ferndocs.com/academy/glossary/conversation-flow.md): How PolyAI agents process conversations.
- [Frequently asked questions](https://poly-ai.ferndocs.com/academy/fa-qs/overview.md): Common questions and troubleshooting solutions for agent configuration, knowledge, rules, and actions.
- [Managed topics FAQ](https://poly-ai.ferndocs.com/academy/fa-qs/managed-topics.md): Guidance on structuring topics, optimizing retrieval, and scaling topic management.
- [Connected knowledge FAQ](https://poly-ai.ferndocs.com/academy/fa-qs/connected-knowledge.md): Learn when to use Connected Knowledge, how it differs from Managed Topics, and how to troubleshoot retrieval.
- [Behavior FAQ](https://poly-ai.ferndocs.com/academy/fa-qs/behavior.md): Guidance on writing effective behavioral rules, channel filtering, and handling edge cases.
- [Actions FAQ](https://poly-ai.ferndocs.com/academy/fa-qs/actions.md): Common questions about configuring actions, combining them, using variables, and debugging failures.
- [Personality and role FAQ](https://poly-ai.ferndocs.com/academy/fa-qs/personality-and-role.md): Learn how to configure your agent's personality, tone, and role using concrete examples.
- [Environments and testing FAQ](https://poly-ai.ferndocs.com/academy/fa-qs/environments-and-testing.md): Guidance on safe testing, deployment pipelines, and managing multi-site agents.
- [Technical considerations FAQ](https://poly-ai.ferndocs.com/academy/fa-qs/technical.md): Answers on ASR/TTS independence, token limits, and context management best practices.
- [Extend with code](https://poly-ai.ferndocs.com/advanced/extend-with-code/overview.md): Write Python functions to integrate APIs, validate input, and add custom business logic to your agent.
- [Agent Development Kit (ADK)](https://poly-ai.ferndocs.com/advanced/extend-with-code/adk.md): Python CLI for building, managing, and deploying PolyAI agents locally with a Git-like pull-edit-push workflow.
- [Overview](https://poly-ai.ferndocs.com/advanced/secrets/overview.md): Store API keys and credentials securely in the Secrets Vault.
- [How to create a secret](https://poly-ai.ferndocs.com/advanced/secrets/how-to-create-a-secret.md): Create a secret in the Secrets Vault
- [Access control](https://poly-ai.ferndocs.com/advanced/secrets/access-control.md): Manage which agents can access secrets
- [Transition functions](https://poly-ai.ferndocs.com/advanced/code-driven-flows/transition-functions.md): Use transition functions to control how your agent moves between steps and flows
- [Flow object](https://poly-ai.ferndocs.com/advanced/code-driven-flows/object.md): The Flow object controls step transitions and exposes the current step name in a flow.
- [ASR biasing](https://poly-ai.ferndocs.com/advanced/code-driven-flows/asr-biasing.md): Configure flow steps to improve speech recognition accuracy for structured inputs like codes and names.
- [DTMF](https://poly-ai.ferndocs.com/advanced/code-driven-flows/dtmf.md): Collect keypad input in flow steps with configurable digit limits, timeouts, and optional recording opt-out.
- [Few-shot prompting](https://poly-ai.ferndocs.com/advanced/code-driven-flows/few-shot-prompting.md): Guide the LLM with example user inputs and expected agent responses to improve accuracy in flows and topics.
- [API reference](https://poly-ai.ferndocs.com/api-reference/api-reference/overview.md): Build, run, and observe PolyAI agents from your own systems. Three API families, one platform, sub-300ms calls in production.
- [API quickstart](https://poly-ai.ferndocs.com/api-reference/api-reference/quickstart.md): Get set up with the PolyAI API: list conversations, pull transcripts and audio, and wire up webhooks.
- [Error codes](https://poly-ai.ferndocs.com/api-reference/api-reference/error-codes.md): HTTP status codes and platform-specific error codes returned by PolyAI APIs.
- [Agents API](https://poly-ai.ferndocs.com/api-reference/build-deploy/agents-api/overview.md): Build, configure, and deploy PolyAI agents programmatically. Manage agents, branches, knowledge bases, telephony, and deployments from your own systems.
- [Chat API](https://poly-ai.ferndocs.com/api-reference/runtime-data/chat-api/overview.md): Use the Chat API to power webchat, in-browser widgets, web SDK implementations, and SMS conversations.
- [Concurrent Calls API](https://poly-ai.ferndocs.com/api-reference/runtime-data/concurrent-calls-api/overview.md): Track concurrent conversations over time for capacity planning and monitoring.
- [Data API](https://poly-ai.ferndocs.com/api-reference/runtime-data/data-api/overview.md): Query conversations, recordings, annotations, notes, and debug chat sessions for your PolyAI agents.
- [Create a new debug chat session](https://poly-ai.ferndocs.com/api-reference/runtime-data/data-api/debug-chat/create-a-new-debug-chat-session.md)
- [Send a message to a debug chat session](https://poly-ai.ferndocs.com/api-reference/runtime-data/data-api/debug-chat/send-a-message-to-a-debug-chat-session.md)
- [DNI API](https://poly-ai.ferndocs.com/api-reference/runtime-data/dni-api/overview.md): Reserve dynamic phone numbers with attached context for marketing, CRM, and web-to-call integrations.
- [External Events API](https://poly-ai.ferndocs.com/api-reference/runtime-data/external-events-api/overview.md): Feed external results (payments, bookings, verifications) back into active conversations asynchronously.
- [Handoff API](https://poly-ai.ferndocs.com/api-reference/runtime-data/handoff-api/overview.md): Retrieve conversation context and metadata when PolyAI agents hand off to live agents or external systems.
- [Messaging API](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/overview.md): Embed real-time text conversations into your application using WebSockets, with handoff to live agents.
- [Sessions and authentication](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/sessions-and-authentication.md): Exchange your connector token for a short-lived access token, then create a session.
- [WebSocket connection](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/web-socket-connection.md): Connect, reconnect, and keep the WebSocket alive.
- [Event format](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/event-format.md): The common JSON envelope used for every WebSocket event.
- [Client events](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/client-events.md): Events your client can send over the WebSocket.
- [Server events](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/server-events.md): Events your client receives over the WebSocket.
- [Streaming](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/streaming.md): Receive agent responses as incremental chunks, like ChatGPT's typing effect.
- [Handoff to live agent](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/handoff-to-live-agent.md): Transfer the conversation from the PolyAI agent to a human agent.
- [Session lifecycle](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/session-lifecycle.md): Every event in order, from connection through session end.
- [Errors](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/errors.md): HTTP status codes and system-message error catalog.
- [Best practices](https://poly-ai.ferndocs.com/api-reference/runtime-data/messaging-api/best-practices.md): Recommendations for connection management, message handling, UX, and security.
- [Outbound Calling API](https://poly-ai.ferndocs.com/api-reference/runtime-data/outbound-calling-api/overview.md): Trigger outbound calls and monitor status for customer outreach, reminders, and notifications.
- [SMS API](https://poly-ai.ferndocs.com/api-reference/runtime-data/sms-api/overview.md): Send and receive SMS messages through your PolyAI agent.
- [WebRTC Gateway API](https://poly-ai.ferndocs.com/api-reference/runtime-data/web-rtc-gateway/overview.md): Enable in-browser voice conversations with PolyAI agents using WebRTC and WebSocket signaling.
- [WebSocket signaling](https://poly-ai.ferndocs.com/api-reference/runtime-data/web-rtc-gateway/web-socket-signaling.md): WebSocket signaling protocol for SDP exchange, ICE candidates, and session management.
- [Alerts API](https://poly-ai.ferndocs.com/api-reference/monitoring/alerts-api/overview.md): Manage alert rules and query active alerts firing on your PolyAI agents.
- [Webhooks API](https://poly-ai.ferndocs.com/api-reference/monitoring/webhooks-api/overview.md): Register webhook endpoints to receive real-time signed notifications for PolyAI events.
- [Conversations API](https://poly-ai.ferndocs.com/api-reference/legacy/conversations-api-v-3-legacy/overview.md): Retrieve conversation transcripts, metadata, and performance metrics for analytics, compliance, and integration.
- [Create a new debug chat session](https://poly-ai.ferndocs.com/api-reference/legacy/conversations-api-v-3-legacy/debug-chat/create-a-new-debug-chat-session.md): Start a new debug chat session to interactively test an agent variant outside of production traffic. Served from api.{region}.poly.ai.
- [Send a message to a debug chat session](https://poly-ai.ferndocs.com/api-reference/legacy/conversations-api-v-3-legacy/debug-chat/send-a-message-to-a-debug-chat-session.md): Send a user turn into an existing debug chat session and return the agent's response. Served from api.{region}.poly.ai.
- [Voice integrations](https://poly-ai.ferndocs.com/integrations/telephony/voice.md): Connect PolyAI to voice platforms for call routing and SIP-based handoffs.
- [Five9](https://poly-ai.ferndocs.com/integrations/telephony/five-9.md): Connect your PolyAI agent to Five9 through a SIP trunk for call routing and handoffs.
- [NICE CXone](https://poly-ai.ferndocs.com/integrations/telephony/nice-c-xone.md): Connect your PolyAI agent to NICE CXone using the Signal API.
- [Twilio](https://poly-ai.ferndocs.com/integrations/telephony/twilio.md): Connect your PolyAI agent to Twilio for voice automation and handoffs.
- [Amazon Connect](https://poly-ai.ferndocs.com/integrations/telephony/amazon-connect/overview.md): Connect your PolyAI agent to Amazon Connect for voice automation and AWS integration.
- [Genesys](https://poly-ai.ferndocs.com/integrations/telephony/genesys.md): Connect your PolyAI agent to Genesys Cloud using BYOC service.
- [Dialpad](https://poly-ai.ferndocs.com/integrations/telephony/dialpad.md): Connect your PolyAI agent to Dialpad for voice automation and handoffs.
- [Salesforce](https://poly-ai.ferndocs.com/integrations/crm/salesforce.md): Connect your PolyAI agent to Salesforce for customer data lookup and case management.
- [Zendesk Talk](https://poly-ai.ferndocs.com/integrations/crm/zendesk-talk.md): Connect to Zendesk Talk to route inbound calls and hand off calls to live agents through SIP.
- [Zendesk Ticketing Solutions](https://poly-ai.ferndocs.com/integrations/crm/zendesk-ticketing-solutions.md): Connect your PolyAI agent to Zendesk for ticket lookup, creation, and updates using API token authentication.
- [OpenTable](https://poly-ai.ferndocs.com/integrations/hospitality/open-table.md): Connect your PolyAI agent to OpenTable for automated restaurant reservation management.
- [Tripleseat](https://poly-ai.ferndocs.com/integrations/hospitality/tripleseat.md): Capture event and large party leads automatically with PolyAI and Tripleseat.
- [HotSOS](https://poly-ai.ferndocs.com/integrations/hospitality/hot-sos.md): Automate room service and maintenance requests with HotSOS and PolyAI.
- [Epic](https://poly-ai.ferndocs.com/integrations/healthcare/epic.md): Connect your PolyAI agent to Epic EHR for patient data access through SMART on FHIR.
- [Gladly](https://poly-ai.ferndocs.com/integrations/knowledge-base/gladly.md): Connect your PolyAI agent to Gladly for real-time knowledge access.
- [Managed services](https://poly-ai.ferndocs.com/integrations/managed-services/overview.md): Integrations that require coordination with your PolyAI account manager.
- [Custom SIP](https://poly-ai.ferndocs.com/integrations/managed-services/telephony/custom-sip.md): Access SIP headers for dynamic routing, personalization, and custom handoffs.
- [DNIs Pool](https://poly-ai.ferndocs.com/integrations/managed-services/telephony/dn-is-pool.md): Integrate your telephony system with PolyAI using a pool of Dynamic Number Insertion (DNI) numbers.
- [Zoom Contact Center](https://poly-ai.ferndocs.com/integrations/managed-services/telephony/zoom-contact-center.md): Integrate PolyAI with Zoom Contact Center for voice agent handling through a SIP trunk.
- [DesignMyNight](https://poly-ai.ferndocs.com/integrations/managed-services/hospitality/design-my-night.md): Connect your PolyAI agent to DesignMyNight for restaurant and venue booking management.
- [LiveRes (Zonal)](https://poly-ai.ferndocs.com/integrations/managed-services/hospitality/live-res-zonal.md): Connect your PolyAI agent to LiveRes for restaurant reservation management.
- [PCI Pal](https://poly-ai.ferndocs.com/integrations/managed-services/payments/pci-pal.md): Integrate PCI Pal for secure, compliant payment processing during calls.
- [Stripe](https://poly-ai.ferndocs.com/integrations/managed-services/payments/stripe.md): Connect your PolyAI agent to Stripe for payment status, refunds, and coupon management.
- [Google Sheets](https://poly-ai.ferndocs.com/integrations/managed-services/data-and-utilities/google-sheets.md): Connect your PolyAI agent to Google Sheets for lookups, logging, and dynamic content.
- [Ideal Postcode](https://poly-ai.ferndocs.com/integrations/managed-services/data-and-utilities/ideal-postcode.md): Enable UK address lookup and validation during calls with Ideal Postcode.
- [DeepL](https://poly-ai.ferndocs.com/integrations/managed-services/data-and-utilities/deep-l.md): Enable real-time translation during calls with DeepL integration.
- [Overview](https://poly-ai.ferndocs.com/release-notes/releases/overview.md)
- [6.2026](https://poly-ai.ferndocs.com/release-notes/releases/2026/6-2026.md): June 2026 release notes.
- [5.2026](https://poly-ai.ferndocs.com/release-notes/releases/2026/5-2026.md): May 2026 release notes.
- [4.2026](https://poly-ai.ferndocs.com/release-notes/releases/2026/4-2026.md): April 2026 release notes.
- [3.2026](https://poly-ai.ferndocs.com/release-notes/releases/2026/3-2026.md): March 2026 release notes.
- [2.2026](https://poly-ai.ferndocs.com/release-notes/releases/2026/2-2026.md): February 2026 release notes.
- [12.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/12-2025.md): December 2025 release notes.
- [11.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/11-2025.md): November 2025 release notes.
- [10.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/10-2025.md): October 2025 release notes.
- [9.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/9-2025.md): September 2025 release notes.
- [8.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/8-2025.md): August 2025 release notes.
- [7.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/7-2025.md): July 2025 release notes.
- [6.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/6-2025.md): June 2025 release notes.
- [5.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/5-2025.md): May 2025 release notes.
- [4.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/4-2025.md): April 2025 release notes.
- [3.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/3-2025.md): March 2025 release notes.
- [2.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/2-2025.md): February 2025 release notes.
- [1.2025](https://poly-ai.ferndocs.com/release-notes/releases/2025/1-2025.md): January 2025 release notes.
- [12.2024](https://poly-ai.ferndocs.com/release-notes/releases/2024/12-2024.md): December 2024 release notes.
- [11.2024](https://poly-ai.ferndocs.com/release-notes/releases/2024/11-2024.md): November 2024 release notes.
- [10.2024](https://poly-ai.ferndocs.com/release-notes/releases/2024/10-2024.md): October 2024 release notes.

## API Docs

- API Reference > Legacy V3 > Conversations [List conversations for a project](https://poly-ai.ferndocs.com/api-reference/api-reference/legacy-v-3/conversations/list.md)
- API Reference > Legacy V1 > Conversations [List](https://poly-ai.ferndocs.com/api-reference/api-reference/legacy-v-1/conversations/list.md)
- API Reference > Agents [List agents](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/list.md)
- API Reference > Agents [Create agent](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/create.md)
- API Reference > Agents [Delete agent](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/delete.md)
- API Reference > Agents [Duplicate agent](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/duplicate.md)
- API Reference > Agents > Voice Library [List all voices in the account's voice library](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/voice-library/list.md)
- API Reference > Agents > Voice Library [Register a new voice in the voice library](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/voice-library/register.md)
- API Reference > Agents > Voice Library [Get a single voice from the voice library](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/voice-library/get.md)
- API Reference > Agents > Voice Library [Update a voice in the voice library](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/voice-library/update.md)
- API Reference > Agents > Voice Library [Synthesize a short audio sample of a voice](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/voice-library/synthesize-sample.md)
- API Reference > Agents > Branches [List branches](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/branches/list.md)
- API Reference > Agents > Branches [Create branch](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/branches/create.md)
- API Reference > Agents > Branches [Delete branch](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/branches/delete.md)
- API Reference > Agents > Branches [Merge branch](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/branches/merge.md)
- API Reference > Agents > Attributes [List attributes](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/attributes/list.md)
- API Reference > Agents > Attributes [Create attribute](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/attributes/create.md)
- API Reference > Agents > Attributes [Delete attribute](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/attributes/delete.md)
- API Reference > Agents > Attributes [Update attribute](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/attributes/update.md)
- API Reference > Agents > Behavior [Get agent behavior rules](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/behavior/get.md)
- API Reference > Agents > Behavior [Update agent behavior rules](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/behavior/update.md)
- API Reference > Agents > Knowledge Base [List knowledge base topics](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/knowledge-base/list.md)
- API Reference > Agents > Knowledge Base [Create knowledge base topic](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/knowledge-base/create.md)
- API Reference > Agents > Knowledge Base [Get knowledge base topic](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/knowledge-base/get.md)
- API Reference > Agents > Knowledge Base [Delete knowledge base topic](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/knowledge-base/delete.md)
- API Reference > Agents > Knowledge Base [Update knowledge base topic](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/knowledge-base/update.md)
- API Reference > Agents > Variants [List variants](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/variants/list.md)
- API Reference > Agents > Variants [Create variant](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/variants/create.md)
- API Reference > Agents > Variants [Delete variant](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/variants/delete.md)
- API Reference > Agents > Variants [Update variant](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/variants/update.md)
- API Reference > Agents > Deployments [List deployments for an environment](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/deployments/list.md)
- API Reference > Agents > Deployments [Get active deployment per environment](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/deployments/get-active.md)
- API Reference > Agents > Deployments [Publish the current draft to an environment](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/deployments/publish.md)
- API Reference > Agents > Deployments [Promote a deployment to the next environment](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/deployments/promote.md)
- API Reference > Agents > Deployments [Rollback to a previous deployment](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/deployments/rollback.md)
- API Reference > Agents > Realtime Configs [List all config pages](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/realtime-configs/list.md)
- API Reference > Agents > Realtime Configs [Get a config page by environment](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/realtime-configs/get.md)
- API Reference > Agents > Realtime Configs [Upsert the JSON Schema for a config page](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/realtime-configs/upsert-schema.md)
- API Reference > Agents > Realtime Configs [Update config variables for an environment](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/realtime-configs/update-variables.md)
- API Reference > Agents > Connectors [List all connectors for a project](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/connectors/list.md)
- API Reference > Agents > Connectors [Batch get connectors by ID](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/connectors/batch-get.md)
- API Reference > Agents > Connectors [Batch update connectors](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/connectors/batch-update.md)
- API Reference > Agents > Connectors [Look up connector by phone number](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/connectors/lookup.md)
- API Reference > Agents > Connectors [Get a connector by ID](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/connectors/get.md)
- API Reference > Agents > Connectors [Delete a connector and its phone numbers](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/connectors/delete.md)
- API Reference > Agents > Connectors [Update a connector](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/connectors/update.md)
- API Reference > Agents > Phone Numbers [List all phone numbers for a project](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/list.md)
- API Reference > Agents > Phone Numbers [Import phone numbers into a project](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/import-batch.md)
- API Reference > Agents > Phone Numbers [Delete phone numbers from a project](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/delete-batch.md)
- API Reference > Agents > Phone Numbers [Batch get phone numbers](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/batch-get.md)
- API Reference > Agents > Phone Numbers [Get a specific phone number](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/get.md)
- API Reference > Agents > Phone Numbers [Import a single phone number](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/import.md)
- API Reference > Agents > Phone Numbers [Delete a single phone number](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/delete.md)
- API Reference > Agents > Phone Numbers [Reassign a phone number to a different connector](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/phone-numbers/reassign.md)
- API Reference > Agents > Audio Cache [List cached audio entries](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/audio-cache/list.md)
- API Reference > Agents > Audio Cache [Delete a cached audio entry](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/audio-cache/delete.md)
- API Reference > Agents > Audio Cache [Download cached audio file](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/audio-cache/download.md)
- API Reference > Agents > Audio Cache [Replace cached audio file](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/audio-cache/replace.md)
- API Reference > Agents > Audio Cache [Replace audio file and voice tuning settings](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/audio-cache/update.md)
- API Reference > Agents > Audio Cache [Synthesize audio preview](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/audio-cache/synthesize.md)
- API Reference > Agents > Audio Cache [Bulk delete cached audio entries](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/audio-cache/bulk-delete.md)
- API Reference > Agents > Outbound Calls [Trigger an outbound call](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/outbound-calls/trigger.md)
- API Reference > Agents > Outbound Calls [Get the status of an outbound call](https://poly-ai.ferndocs.com/api-reference/api-reference/agents/outbound-calls/get-status.md)
- API Reference > Alerts [List alert rules](https://poly-ai.ferndocs.com/api-reference/api-reference/alerts/list-rules.md)
- API Reference > Alerts [Create an alert rule](https://poly-ai.ferndocs.com/api-reference/api-reference/alerts/create-rule.md)
- API Reference > Alerts [Get an alert rule](https://poly-ai.ferndocs.com/api-reference/api-reference/alerts/get-rule.md)
- API Reference > Alerts [Delete an alert rule](https://poly-ai.ferndocs.com/api-reference/api-reference/alerts/delete-rule.md)
- API Reference > Alerts [Update an alert rule](https://poly-ai.ferndocs.com/api-reference/api-reference/alerts/update-rule.md)
- API Reference > Alerts [Get active alerts](https://poly-ai.ferndocs.com/api-reference/api-reference/alerts/list-active.md)
- API Reference > Chat [Create a new chat conversation](https://poly-ai.ferndocs.com/api-reference/api-reference/chat/create.md)
- API Reference > Chat [Send a message to an existing chat conversation](https://poly-ai.ferndocs.com/api-reference/api-reference/chat/respond.md)
- API Reference > Chat [Close an existing chat conversation](https://poly-ai.ferndocs.com/api-reference/api-reference/chat/close.md)
- API Reference > Concurrent Calls [Get distribution of the maximum number of concurrent conversations](https://poly-ai.ferndocs.com/api-reference/api-reference/concurrent-calls/get-max.md)
- API Reference > Data [List conversations for a project](https://poly-ai.ferndocs.com/api-reference/api-reference/data/list-conversations.md)
- API Reference > Data [Get a conversation by ID](https://poly-ai.ferndocs.com/api-reference/api-reference/data/get-conversation.md)
- API Reference > Data [Add annotations to a conversation](https://poly-ai.ferndocs.com/api-reference/api-reference/data/add-annotation.md)
- API Reference > Data [Get audio recording for a conversation](https://poly-ai.ferndocs.com/api-reference/api-reference/data/get-conversation-audio.md)
- API Reference > Data [Upsert a note on a conversation](https://poly-ai.ferndocs.com/api-reference/api-reference/data/upsert-note.md)
- API Reference > Data > Debug Chat [Create a new debug chat session](https://poly-ai.ferndocs.com/api-reference/api-reference/data/debug-chat/start.md)
- API Reference > Data > Debug Chat [Send a message to a debug chat session](https://poly-ai.ferndocs.com/api-reference/api-reference/data/debug-chat/respond.md)
- API Reference > Dni [Reserve a DNI (Dynamic Number Insertion) for an incoming call.](https://poly-ai.ferndocs.com/api-reference/api-reference/dni/reserve.md)
- API Reference > External Events [Bridge ended notification](https://poly-ai.ferndocs.com/api-reference/api-reference/external-events/bridge-ended.md)
- API Reference > External Events [External events webhook (provider → PolyAI)](https://poly-ai.ferndocs.com/api-reference/api-reference/external-events/webhook.md)
- API Reference > Handoff [Get handoff state information for a call.](https://poly-ai.ferndocs.com/api-reference/api-reference/handoff/get-state.md)
- API Reference > Outbound [Trigger an outbound call](https://poly-ai.ferndocs.com/api-reference/api-reference/outbound/trigger.md)
- API Reference > Outbound [Get call status](https://poly-ai.ferndocs.com/api-reference/api-reference/outbound/get-status.md)
- API Reference > Webhooks [List webhook endpoints](https://poly-ai.ferndocs.com/api-reference/api-reference/webhooks/list.md)
- API Reference > Webhooks [Create a webhook endpoint](https://poly-ai.ferndocs.com/api-reference/api-reference/webhooks/create.md)
- API Reference > Webhooks [Get a webhook endpoint](https://poly-ai.ferndocs.com/api-reference/api-reference/webhooks/get.md)
- API Reference > Webhooks [Delete a webhook endpoint](https://poly-ai.ferndocs.com/api-reference/api-reference/webhooks/delete.md)
- API Reference > Webhooks [Update a webhook endpoint](https://poly-ai.ferndocs.com/api-reference/api-reference/webhooks/update.md)
- API Reference > Webhooks [Rotate webhook signing secret](https://poly-ai.ferndocs.com/api-reference/api-reference/webhooks/rotate-secret.md)
- API Reference > Webrtc [Health check](https://poly-ai.ferndocs.com/api-reference/api-reference/webrtc/health.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://poly-ai.ferndocs.com/openapi.json)
- [OpenAPI YAML](https://poly-ai.ferndocs.com/openapi.yaml)