# Telnyx AI: Assistants — Documentation Index
> Assistants documentation within the AI section of the Telnyx developer docs (https://developers.telnyx.com).
> Root index: https://developers.telnyx.com/llms.txt · AI index: https://telnyx.com/llms/ai.txt · Full content for this subsection: https://telnyx.com/llms/ai/assistants-full.txt

## Assistants

- [Voice Assistant](https://developers.telnyx.com/docs/inference/ai-assistants/no-code-voice-assistant.md): Build a voice AI assistant in the Telnyx portal without writing code. Pick a model and voice, attach a phone number, and start taking inbound calls.
- [Multi-Participant Calls](https://developers.telnyx.com/docs/inference/ai-assistants/multi-participant-calls.md): Invite additional participants into a live Voice AI call and control when your assistant should speak or stay silent.
- [Memory](https://developers.telnyx.com/docs/inference/ai-assistants/memory.md): Give Telnyx AI Assistants long-term memory so they recall caller details across sessions. Configure memory scope, retrieval, and conversation history.
- [Dynamic Variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables.md): Personalize Telnyx AI Assistant prompts with dynamic variables. Pass caller context, account data, and CRM fields at runtime into the assistant instructions.
- [Conversation Workflows](https://developers.telnyx.com/docs/inference/ai-assistants/workflows.md): Design multi-step Telnyx AI Assistant conversations with workflow nodes, conditional routing, per-step instructions, model and voice overrides, and assistant routing.
- [Async Tools](https://developers.telnyx.com/docs/inference/ai-assistants/async-tools.md): Build responsive Telnyx AI Assistants that keep talking while slow backends run. Use async webhooks and the Add Messages API together or independently.
- [Tools Library](https://developers.telnyx.com/docs/inference/ai-assistants/tools-library.md): Create tools once and share them across all your AI assistants. Migrate legacy tools at your own pace.
- [Agent Handoff](https://developers.telnyx.com/docs/inference/ai-assistants/agent-handoff.md): Enable seamless AI-to-AI handoffs with specialized assistants working together in a single conversation, providing expert-level support across multiple domains.
- [Voicemail Detection on Transfer](https://developers.telnyx.com/docs/inference/ai-assistants/voicemail-detection-on-transfer.md): Configure Voice AI Assistants to detect voicemail on transferred calls and respond automatically.
- [Scheduled Events](https://developers.telnyx.com/docs/inference/ai-assistants/scheduled-events.md): Schedule outbound phone calls and SMS messages from Voice AI Assistants, with configurable retry policies for unanswered calls.
- [Transcription Settings](https://developers.telnyx.com/docs/inference/ai-assistants/transcription-settings.md): Choose and configure speech-to-text (STT) models for AI Assistants, including Deepgram, Azure, AssemblyAI, and xAI models.
- [Integrations](https://developers.telnyx.com/docs/inference/ai-assistants/integrations.md): Connect Telnyx AI Assistants with Salesforce, ServiceNow, HubSpot, and developer tools like Coval to automate workflows and evaluate assistant quality.
- [Testing, Versions & Traffic Distribution](https://developers.telnyx.com/docs/inference/ai-assistants/version-testing-traffic-distribution.md): A/B test Telnyx AI Assistant versions in production. Split traffic across prompts, models, and voices to measure quality before promoting a new version.
- [Importing Assistants](https://developers.telnyx.com/docs/inference/ai-assistants/importing.md): Import AI assistants from OpenAI, ElevenLabs, Vapi, and other providers into Telnyx. Migrate prompts, voices, tools, and knowledge bases in a few steps.
- [Custom LLMs for Assistants](https://developers.telnyx.com/docs/inference/ai-assistants/custom-llm.md): Configure Azure OpenAI, AWS Bedrock, Baseten, or any OpenAI-compatible endpoint as a custom LLM provider for your Telnyx AI assistants.
- [Data Residency & Compliance FAQ](https://developers.telnyx.com/docs/inference/data-residency.md): How Telnyx handles processing location, storage at rest, self-hosted vs third-party STT/TTS/LLM providers, data retention, and model training across the Inference API and Voice AI Assistants.
- [Session Analysis](https://developers.telnyx.com/docs/reporting/session-analysis.md): Analyze SIP session quality with Telnyx Session Analysis. Pull call detail records, MOS scores, and packet metrics to diagnose voice quality issues.

## Missions

- [Voice Outreach](https://developers.telnyx.com/docs/inference/missions.md): Give your AI agent a mission to research businesses, make phone calls, and report back with results — all tracked and auditable through the Telnyx Missions API.

## Analytics

- [Creating insights](https://developers.telnyx.com/docs/inference/ai-insights/creating-insights.md): Step-by-step guide to creating AI Insights in the Mission Control Portal to analyze your AI Assistant conversations.
- [Use cases](https://developers.telnyx.com/docs/inference/ai-insights/use-cases.md): Industry-specific examples and implementation patterns for AI Insights across healthcare, customer support, sales, e-commerce, and financial services.
- [Structured insights](https://developers.telnyx.com/docs/inference/ai-insights/structured-insights.md): Create AI Insights with defined JSON schemas for consistent, structured data extraction from conversations.
- [Insight groups](https://developers.telnyx.com/docs/inference/ai-insights/insight-groups.md): Organize AI Insights into reusable groups and configure webhook delivery for automated insights distribution.
- [Embeddings](https://developers.telnyx.com/docs/inference/embeddings.md): Generate vector embeddings with the Telnyx Inference API for semantic search, clustering, and RAG. Supports multiple embedding models and batch requests.
- [Clusters](https://developers.telnyx.com/docs/inference/clusters.md): Group similar documents and discover themes in your data with Telnyx Inference clusters. Run unsupervised clustering on embeddings to surface insights.

## API Reference (Assistants)

### Assistants

- [List assistants](https://developers.telnyx.com/api-reference/assistants/list-assistants.md): Retrieve a list of all AI Assistants configured by the user.
- [Create an assistant](https://developers.telnyx.com/api-reference/assistants/create-an-assistant.md): Create a new AI Assistant.
- [Get an assistant](https://developers.telnyx.com/api-reference/assistants/get-an-assistant.md): Retrieve an AI Assistant configuration by `assistant_id`.
- [Update an assistant](https://developers.telnyx.com/api-reference/assistants/update-an-assistant.md): Update an AI Assistant's attributes.
- [Delete an assistant](https://developers.telnyx.com/api-reference/assistants/delete-an-assistant.md): Delete an AI Assistant by `assistant_id`.
- [Assistant Chat (BETA)](https://developers.telnyx.com/api-reference/assistants/assistant-chat-beta.md): This endpoint allows a client to send a chat message to a specific AI Assistant. The assistant processes the message and returns a relevant reply based on the…
- [Assistant Sms Chat](https://developers.telnyx.com/api-reference/assistants/assistant-sms-chat.md): Send an SMS message for an assistant. This endpoint:
- [Clone Assistant](https://developers.telnyx.com/api-reference/assistants/clone-assistant.md): Clone an existing assistant, excluding telephony and messaging settings.
- [Import assistants from external provider](https://developers.telnyx.com/api-reference/assistants/import-assistants-from-external-provider.md): Import assistants from external providers. Any assistant that has already been imported will be overwritten with its latest version from the importing provider.
- [List scheduled events](https://developers.telnyx.com/api-reference/assistants/list-scheduled-events.md): Get scheduled events for an assistant with pagination and filtering
- [Create a scheduled event](https://developers.telnyx.com/api-reference/assistants/create-a-scheduled-event.md): Create a scheduled event for an assistant
- [Get a scheduled event](https://developers.telnyx.com/api-reference/assistants/get-a-scheduled-event.md): Retrieve a scheduled event by event ID
- [Delete a scheduled event](https://developers.telnyx.com/api-reference/assistants/delete-a-scheduled-event.md): If the event is pending, this will cancel the event. Otherwise, this will simply remove the record of the event.
- [List assistant tests with pagination](https://developers.telnyx.com/api-reference/assistants/list-assistant-tests-with-pagination.md): Retrieves a paginated list of assistant tests with optional filtering capabilities
- [Create a new assistant test](https://developers.telnyx.com/api-reference/assistants/create-a-new-assistant-test.md): Creates a comprehensive test configuration for evaluating AI assistant performance
- [Get all test suite names](https://developers.telnyx.com/api-reference/assistants/get-all-test-suite-names.md): Retrieves a list of all distinct test suite names available to the current user
- [Get test suite run history](https://developers.telnyx.com/api-reference/assistants/get-test-suite-run-history.md): Retrieves paginated history of test runs for a specific test suite with filtering options
- [Trigger test suite execution](https://developers.telnyx.com/api-reference/assistants/trigger-test-suite-execution.md): Executes all tests within a specific test suite as a batch operation
- [Get assistant test by ID](https://developers.telnyx.com/api-reference/assistants/get-assistant-test-by-id.md): Retrieves detailed information about a specific assistant test
- [Update an assistant test](https://developers.telnyx.com/api-reference/assistants/update-an-assistant-test.md): Updates an existing assistant test configuration with new settings
- [Delete an assistant test](https://developers.telnyx.com/api-reference/assistants/delete-an-assistant-test.md): Permanently removes an assistant test and all associated data
- [Get test run history for a specific test](https://developers.telnyx.com/api-reference/assistants/get-test-run-history-for-a-specific-test.md): Retrieves paginated execution history for a specific assistant test with filtering options
- [Trigger a manual test run](https://developers.telnyx.com/api-reference/assistants/trigger-a-manual-test-run.md): Initiates immediate execution of a specific assistant test
- [Get specific test run details](https://developers.telnyx.com/api-reference/assistants/get-specific-test-run-details.md): Retrieves detailed information about a specific test run execution
- [Get all versions of an assistant](https://developers.telnyx.com/api-reference/assistants/get-all-versions-of-an-assistant.md): Retrieves all versions of a specific assistant with complete configuration and metadata
- [Get a specific assistant version](https://developers.telnyx.com/api-reference/assistants/get-a-specific-assistant-version.md): Retrieves a specific version of an assistant by assistant_id and version_id
- [Update a specific assistant version](https://developers.telnyx.com/api-reference/assistants/update-a-specific-assistant-version.md): Updates the configuration of a specific assistant version. Can not update main version
- [Delete a specific assistant version](https://developers.telnyx.com/api-reference/assistants/delete-a-specific-assistant-version.md): Permanently removes a specific version of an assistant. Can not delete main version
- [Promote an assistant version to main](https://developers.telnyx.com/api-reference/assistants/promote-an-assistant-version-to-main.md): Promotes a specific version to be the main/current version of the assistant. This will delete any existing canary deploy configuration and send all live produc…
- [Get Canary Deploy](https://developers.telnyx.com/api-reference/assistants/get-canary-deploy.md): Endpoint to get a canary deploy configuration for an assistant.
- [Create Canary Deploy](https://developers.telnyx.com/api-reference/assistants/create-canary-deploy.md): Endpoint to create a canary deploy configuration for an assistant.
- [Update Canary Deploy](https://developers.telnyx.com/api-reference/assistants/update-canary-deploy.md): Endpoint to update a canary deploy configuration for an assistant.
- [Delete Canary Deploy](https://developers.telnyx.com/api-reference/assistants/delete-canary-deploy.md): Endpoint to delete a canary deploy configuration for an assistant.
- [Get assistant texml](https://developers.telnyx.com/api-reference/assistants/get-assistant-texml.md): Get an assistant texml by `assistant_id`.
- [Test Assistant Tool](https://developers.telnyx.com/api-reference/assistants/test-assistant-tool.md): Test a webhook tool for an assistant
- [Get All Tags](https://developers.telnyx.com/api-reference/assistants/get-all-tags.md)
- [Add Assistant Tag](https://developers.telnyx.com/api-reference/assistants/add-assistant-tag.md)
- [Remove Assistant Tag](https://developers.telnyx.com/api-reference/assistants/remove-assistant-tag.md)
- [Add Assistant Tool](https://developers.telnyx.com/api-reference/assistants/add-assistant-tool.md)
- [Remove Assistant Tool](https://developers.telnyx.com/api-reference/assistants/remove-assistant-tool.md)

### Integrations

- [List Integrations](https://developers.telnyx.com/api-reference/integrations/list-integrations.md): List all available integrations.
- [List User Integrations](https://developers.telnyx.com/api-reference/integrations/list-user-integrations.md): List user setup integrations
- [Get User Integration connection By Id](https://developers.telnyx.com/api-reference/integrations/get-user-integration-connection-by-id.md): Get user setup integrations
- [Delete Integration Connection](https://developers.telnyx.com/api-reference/integrations/delete-integration-connection.md): Delete a specific integration connection.
- [List Integration By Id](https://developers.telnyx.com/api-reference/integrations/list-integration-by-id.md): Retrieve integration details

### MCP Servers

- [List MCP Servers](https://developers.telnyx.com/api-reference/mcp-servers/list-mcp-servers.md): Retrieve a list of MCP servers.
- [Create MCP Server](https://developers.telnyx.com/api-reference/mcp-servers/create-mcp-server.md): Create a new MCP server.
- [Get MCP Server](https://developers.telnyx.com/api-reference/mcp-servers/get-mcp-server.md): Retrieve details for a specific MCP server.
- [Update MCP Server](https://developers.telnyx.com/api-reference/mcp-servers/update-mcp-server.md): Update an existing MCP server.
- [Delete MCP Server](https://developers.telnyx.com/api-reference/mcp-servers/delete-mcp-server.md): Delete a specific MCP server.

### Missions

- [List missions](https://developers.telnyx.com/api-reference/missions/list-missions.md): List all missions for the organization
- [Create mission](https://developers.telnyx.com/api-reference/missions/create-mission.md): Create a new mission definition
- [List recent events](https://developers.telnyx.com/api-reference/missions/list-recent-events.md): List recent events across all missions
- [List recent runs](https://developers.telnyx.com/api-reference/missions/list-recent-runs.md): List recent runs across all missions
- [Get mission](https://developers.telnyx.com/api-reference/missions/get-mission.md): Get a mission by ID (includes tools, knowledge_bases, mcp_servers)
- [Update mission](https://developers.telnyx.com/api-reference/missions/update-mission.md): Update a mission definition
- [Delete mission](https://developers.telnyx.com/api-reference/missions/delete-mission.md): Delete a mission
- [Clone mission](https://developers.telnyx.com/api-reference/missions/clone-mission.md): Clone an existing mission
- [List runs for mission](https://developers.telnyx.com/api-reference/missions/list-runs-for-mission.md): List all runs for a specific mission
- [Start a run](https://developers.telnyx.com/api-reference/missions/start-a-run.md): Start a new run for a mission
- [Get run details](https://developers.telnyx.com/api-reference/missions/get-run-details.md): Get details of a specific run
- [Update run](https://developers.telnyx.com/api-reference/missions/update-run.md): Update run status and/or result
- [Cancel run](https://developers.telnyx.com/api-reference/missions/cancel-run.md): Cancel a running or paused run
- [List events](https://developers.telnyx.com/api-reference/missions/list-events.md): List events for a run (paginated)
- [Log event](https://developers.telnyx.com/api-reference/missions/log-event.md): Log an event for a run
- [Get event details](https://developers.telnyx.com/api-reference/missions/get-event-details.md): Get details of a specific event
- [Pause run](https://developers.telnyx.com/api-reference/missions/pause-run.md): Pause a running run
- [Get plan](https://developers.telnyx.com/api-reference/missions/get-plan.md): Get the plan (all steps) for a run
- [Create initial plan](https://developers.telnyx.com/api-reference/missions/create-initial-plan.md): Create the initial plan for a run
- [Add step(s) to plan](https://developers.telnyx.com/api-reference/missions/add-steps-to-plan.md): Add one or more steps to an existing plan
- [Get step details](https://developers.telnyx.com/api-reference/missions/get-step-details.md): Get details of a specific plan step
- [Update step status](https://developers.telnyx.com/api-reference/missions/update-step-status.md): Update the status of a plan step
- [Resume run](https://developers.telnyx.com/api-reference/missions/resume-run.md): Resume a paused run
- [List linked Telnyx agents](https://developers.telnyx.com/api-reference/missions/list-linked-telnyx-agents.md): List all Telnyx agents linked to a run
- [Link Telnyx agent to run](https://developers.telnyx.com/api-reference/missions/link-telnyx-agent-to-run.md): Link a Telnyx AI agent (voice/messaging) to a run
- [Unlink Telnyx agent](https://developers.telnyx.com/api-reference/missions/unlink-telnyx-agent.md): Unlink a Telnyx agent from a run
- [List knowledge bases](https://developers.telnyx.com/api-reference/missions/list-knowledge-bases.md): List all knowledge bases for a mission
- [Create knowledge base](https://developers.telnyx.com/api-reference/missions/create-knowledge-base.md): Create a new knowledge base for a mission
- [Get knowledge base](https://developers.telnyx.com/api-reference/missions/get-knowledge-base.md): Get a specific knowledge base by ID
- [Update knowledge base](https://developers.telnyx.com/api-reference/missions/update-knowledge-base.md): Update a knowledge base definition
- [Delete knowledge base](https://developers.telnyx.com/api-reference/missions/delete-knowledge-base.md): Delete a knowledge base from a mission
- [List MCP servers](https://developers.telnyx.com/api-reference/missions/list-mcp-servers.md): List all MCP servers for a mission
- [Create MCP server](https://developers.telnyx.com/api-reference/missions/create-mcp-server.md): Create a new MCP server for a mission
- [Get MCP server](https://developers.telnyx.com/api-reference/missions/get-mcp-server.md): Get a specific MCP server by ID
- [Update MCP server](https://developers.telnyx.com/api-reference/missions/update-mcp-server.md): Update an MCP server definition
- [Delete MCP server](https://developers.telnyx.com/api-reference/missions/delete-mcp-server.md): Delete an MCP server from a mission
- [List tools](https://developers.telnyx.com/api-reference/missions/list-tools.md): List all tools for a mission
- [Create tool](https://developers.telnyx.com/api-reference/missions/create-tool.md): Create a new tool for a mission
- [Get tool](https://developers.telnyx.com/api-reference/missions/get-tool.md): Get a specific tool by ID
- [Update tool](https://developers.telnyx.com/api-reference/missions/update-tool.md): Update a tool definition
- [Delete tool](https://developers.telnyx.com/api-reference/missions/delete-tool.md): Delete a tool from a mission

### Conversations

- [List conversations](https://developers.telnyx.com/api-reference/conversations/list-conversations.md): Retrieve a list of all AI conversations configured by the user. Supports PostgREST-style query parameters for filtering. Examples are included for the standard…
- [Create a conversation](https://developers.telnyx.com/api-reference/conversations/create-a-conversation.md): Create a new AI Conversation.
- [Get Insight Template Groups](https://developers.telnyx.com/api-reference/conversations/get-insight-template-groups.md): Get all insight groups
- [Create Insight Template Group](https://developers.telnyx.com/api-reference/conversations/create-insight-template-group.md): Create a new insight group
- [Get Insight Template Group](https://developers.telnyx.com/api-reference/conversations/get-insight-template-group.md): Get insight group by ID
- [Update Insight Template Group](https://developers.telnyx.com/api-reference/conversations/update-insight-template-group.md): Update an insight template group
- [Delete Insight Template Group](https://developers.telnyx.com/api-reference/conversations/delete-insight-template-group.md): Delete insight group by ID
- [Assign Insight Template To Group](https://developers.telnyx.com/api-reference/conversations/assign-insight-template-to-group.md): Assign an insight to a group
- [Unassign Insight Template From Group](https://developers.telnyx.com/api-reference/conversations/unassign-insight-template-from-group.md): Remove an insight from a group
- [Get Insight Templates](https://developers.telnyx.com/api-reference/conversations/get-insight-templates.md): Get all insights
- [Create Insight Template](https://developers.telnyx.com/api-reference/conversations/create-insight-template.md): Create a new insight
- [Get Insight Template](https://developers.telnyx.com/api-reference/conversations/get-insight-template.md): Get insight by ID
- [Update Insight Template](https://developers.telnyx.com/api-reference/conversations/update-insight-template.md): Update an insight template
- [Delete Insight Template](https://developers.telnyx.com/api-reference/conversations/delete-insight-template.md): Delete insight by ID
- [Get a conversation](https://developers.telnyx.com/api-reference/conversations/get-a-conversation.md): Retrieve a specific AI conversation by its ID.
- [Update conversation metadata](https://developers.telnyx.com/api-reference/conversations/update-conversation-metadata.md): Update metadata for a specific conversation.
- [Delete a conversation](https://developers.telnyx.com/api-reference/conversations/delete-a-conversation.md): Delete a specific conversation by its ID.
- [Get insights for a conversation](https://developers.telnyx.com/api-reference/conversations/get-insights-for-a-conversation.md): Retrieve insights for a specific conversation
- [Create Message](https://developers.telnyx.com/api-reference/conversations/create-message.md): Add a new message to the conversation. Used to insert a new messages to a conversation manually ( without using chat endpoint )
- [Get conversation messages](https://developers.telnyx.com/api-reference/conversations/get-conversation-messages.md): Retrieve messages for a specific conversation, including tool calls made by the assistant.

### Embeddings

- [Get Tasks by Status](https://developers.telnyx.com/api-reference/embeddings/get-tasks-by-status.md): Retrieve tasks for the user that are either `queued`, `processing`, `failed`, `success` or `partial_success` based on the query string. Defaults to `queued` an…
- [Embed documents](https://developers.telnyx.com/api-reference/embeddings/embed-documents.md): Perform embedding on a Telnyx Storage Bucket using the a embedding model.
- [List embedded buckets](https://developers.telnyx.com/api-reference/embeddings/list-embedded-buckets.md): Get all embedding buckets for a user.
- [Get file-level embedding statuses for a bucket](https://developers.telnyx.com/api-reference/embeddings/get-file-level-embedding-statuses-for-a-bucket.md): Get all embedded files for a given user bucket, including their processing status.
- [Disable AI for an Embedded Bucket](https://developers.telnyx.com/api-reference/embeddings/disable-ai-for-an-embedded-bucket.md): Deletes an entire bucket's embeddings and disables the bucket for AI-use, returning it to normal storage pricing.
- [Search for documents](https://developers.telnyx.com/api-reference/embeddings/search-for-documents.md): Perform a similarity search on a Telnyx Storage Bucket, returning the most similar `num_docs` document chunks to the query.
- [Embed URL content](https://developers.telnyx.com/api-reference/embeddings/embed-url-content.md): Embed website content from a specified URL, including child pages up to 5 levels deep within the same domain. The process crawls and loads content from the mai…
- [Get an embedding task's status](https://developers.telnyx.com/api-reference/embeddings/get-an-embedding-tasks-status.md): Check the status of a current embedding task. Will be one of the following:

### Clusters

- [List all clusters](https://developers.telnyx.com/api-reference/clusters/list-all-clusters.md)
- [Compute new clusters](https://developers.telnyx.com/api-reference/clusters/compute-new-clusters.md): Starts a background task to compute how the data in an embedded storage bucket is clustered. This helps identify common themes and patterns in the data.
- [Fetch a cluster](https://developers.telnyx.com/api-reference/clusters/fetch-a-cluster.md)
- [Delete a cluster](https://developers.telnyx.com/api-reference/clusters/delete-a-cluster.md)
- [Fetch a cluster visualization](https://developers.telnyx.com/api-reference/clusters/fetch-a-cluster-visualization.md)