# Threetone Documentation

> Build, integrate, and operate Threetone agents and workspace APIs.

- [Introduction](https://docs.threetone.in/overview/intro.md): Understand Threetone Agents Platform, its core resources, and the guides for configuring agents and managing your workspace.
- [Models and voices](https://docs.threetone.in/overview/models.md): Choose compatible language, speech-recognition and speech-generation models, saved voices, and language settings for an agent configuration.
- [Account](https://docs.threetone.in/overview/administration/account.md): Review your profile, update your name, manage two-factor authentication, and find workspace and subscription settings.
- [Billing](https://docs.threetone.in/overview/administration/billing.md): Understand subscriptions, credit information, billing access, and the planned prepaid usage model for Threetone.
- [Subscriptions](https://docs.threetone.in/overview/administration/billing/subscriptions.md): Review your plan, start a supported checkout, open billing management, and understand scheduled subscription cancellation.
- [Credits and usage](https://docs.threetone.in/overview/administration/billing/credits-and-usage.md): Interpret saved subscription balances, distinguish usage totals from period measurements, and check current billing information.
- [Planned pricing](https://docs.threetone.in/overview/administration/billing/pricing.md): Review Threetone's draft monthly agent plans and usage rates before the billing catalog and released product are aligned.
- [Pay as you go](https://docs.threetone.in/overview/administration/pay-as-you-go.md): Understand Threetone's planned prepaid usage model and the controls that must be available before top-ups are released.
- [Consolidated billing](https://docs.threetone.in/overview/administration/consolidated-billing.md): Prepare a billing review across workspaces and understand the limits of existing subscription and quota reads.
- [Data residency](https://docs.threetone.in/overview/administration/data-residency.md): Document regional data-handling requirements and the evidence needed before relying on a residency commitment.
- [Usage analytics](https://docs.threetone.in/overview/administration/usage-analytics.md): Separate saved subscription balances, operational dashboard metrics, and planned public usage reports.
- [Workspace assets](https://docs.threetone.in/overview/administration/assets.md): Inventory agents, documents, tools, and media through their existing resource workflows.
- [Workspaces](https://docs.threetone.in/overview/administration/workspaces/overview.md): Review your Threetone workspace, update its name, and find members, groups, subscription details, and API keys.
- [Members and access](https://docs.threetone.in/overview/administration/workspaces/members.md): Invite teammates, review workspace seats and groups, and understand how resource sharing differs from API-key permissions.
- [Billing groups](https://docs.threetone.in/overview/administration/workspaces/billing-groups.md): Understand existing group-aware billing metadata and prepare a workspace allocation plan.
- [Service accounts](https://docs.threetone.in/overview/administration/workspaces/service-accounts.md): Prepare machine identities and access requirements while service-account operations are unavailable.
- [API keys](https://docs.threetone.in/overview/administration/workspaces/api-keys.md): Create a scoped personal API key in Threetone, store it securely, and replace or revoke it when your integration changes.
- [Domain verification](https://docs.threetone.in/overview/administration/workspaces/domain-verification.md): Prepare domain ownership and identity-routing requirements without assuming a self-service verification workflow.
- [Single sign-on](https://docs.threetone.in/overview/administration/workspaces/sso.md): Use the existing SSO entry for configured organizations and prepare provider, provisioning, and recovery requirements.
- [Microsoft Entra SAML SSO](https://docs.threetone.in/overview/administration/workspaces/sso/microsoft-entra-saml.md): Prepare Microsoft Entra connection details and a controlled sign-in review for a supported Threetone organization.
- [Okta SAML SSO](https://docs.threetone.in/overview/administration/workspaces/sso/okta-saml.md): Prepare Okta connection values, application assignments, and sign-in checks for an approved Threetone setup.
- [SCIM provisioning](https://docs.threetone.in/overview/administration/workspaces/sso/scim.md): Prepare directory ownership, user and group mappings, and lifecycle verification before relying on automated provisioning.
- [Sharing resources](https://docs.threetone.in/overview/administration/workspaces/sharing-resources.md): Inspect resource grants and share eligible workspace resources with a member or group through the API.
- [User groups](https://docs.threetone.in/overview/administration/workspaces/user-groups.md): Create and maintain workspace groups, review membership, and distinguish group access from billing allocation.
- [Model approvals](https://docs.threetone.in/overview/administration/workspaces/model-approvals.md): Review workspace model availability and prepare model-admission requirements without assuming an approval editor exists.
- [Audit logs](https://docs.threetone.in/overview/administration/workspaces/audit-logs.md): Prepare an administrative event-review policy and understand the current placeholder audit-log API.
- [Agents Platform](https://docs.threetone.in/agents-platform/overview.md): Learn the resources and workflows for configuring agents, managing changes, connecting knowledge and tools, and inspecting conversation records.
- [Create your first agent](https://docs.threetone.in/agents-platform/get-started/first-agent.md): Create a blank agent in the dashboard, prepare its behavior, and understand how to preserve a configuration draft.
- [API quickstart](https://docs.threetone.in/agents-platform/get-started/api-quickstart.md): Authenticate, choose compatible models and a saved voice, and create an agent with the Threetone API.
- [Configure an agent](https://docs.threetone.in/agents-platform/configure/overview.md): Configure behavior, speech, knowledge, tools, personalization, authentication, and integrations, then review the saved agent version.
- [Agent configuration](https://docs.threetone.in/agents-platform/configure/agent-behavior/overview.md): Configure an agent's first message, prompt, language, models, and resource references, then review the complete saved version.
- [Write an agent prompt](https://docs.threetone.in/agents-platform/configure/agent-behavior/prompting.md): Define an agent's task, boundaries, first message, and response rules, then review prompt changes before publication.
- [Models](https://docs.threetone.in/agents-platform/configure/agent-behavior/models.md): Choose a managed language model, review supported generation settings, and save a configuration with compatible backups.
- [Workflows](https://docs.threetone.in/agents-platform/configure/agent-behavior/workflows.md): Author a graph of agent instructions, tools, and transitions, then review its structure in a saved draft.
- [Procedures](https://docs.threetone.in/agents-platform/configure/agent-behavior/procedures.md): Create branch-scoped procedure drafts, review their triggers and content, and compile a workflow preview.
- [Free-form procedures](https://docs.threetone.in/agents-platform/configure/agent-behavior/procedures/free-form.md): Write a focused procedure, save it on an agent branch, and inspect how its instructions appear in a compiled workflow preview.
- [Structured procedures](https://docs.threetone.in/agents-platform/configure/agent-behavior/procedures/structured.md): Prepare typed procedure steps, resolve resource references, and review compiler validation without assuming deterministic execution.
- [Multimodal input](https://docs.threetone.in/agents-platform/configure/agent-behavior/multimodal-input.md): Prepare file-input limits and representative image or document examples while multimodal conversation support remains planned.
- [Conversation flow](https://docs.threetone.in/agents-platform/configure/agent-behavior/conversation-flow.md): Configure first-message interruptions and soft timeouts, then review the saved turn settings on an agent version.
- [Channel behavior](https://docs.threetone.in/agents-platform/configure/agent-behavior/channel-behavior.md): Prepare response length, formatting, and interaction-budget settings for different text conversation sources.
- [Guardrails](https://docs.threetone.in/agents-platform/configure/agent-behavior/guardrails.md): Define conversation boundaries and review guardrail configuration while dashboard enforcement controls remain in preview.
- [Voice and language](https://docs.threetone.in/agents-platform/configure/voice-and-language/overview.md): Prepare compatible speech-recognition, voice, and response-language settings in a server draft while voice publication remains unavailable.
- [Language](https://docs.threetone.in/agents-platform/configure/voice-and-language/language.md): Separate response language from speech recognition, prepare language-specific text, and inspect the saved draft.
- [Multiple voices](https://docs.threetone.in/agents-platform/configure/voice-and-language/multiple-voices.md): Prepare a default saved voice and compatible language-specific voice overrides without assuming live multi-speaker support.
- [Pronunciation](https://docs.threetone.in/agents-platform/configure/voice-and-language/pronunciation.md): Prepare difficult terms and review pronunciation dictionary and phoneme settings against the selected speech model.
- [Speed](https://docs.threetone.in/agents-platform/configure/voice-and-language/speed.md): Prepare speech-rate options using the selected model's schema and a consistent listening script.
- [Expressive mode](https://docs.threetone.in/agents-platform/configure/voice-and-language/expressive-mode.md): Prepare expressive speech deliberately and check model-specific emotion or audio-tag capabilities before authoring settings.
- [Audio environment](https://docs.threetone.in/agents-platform/configure/voice-and-language/audio-environment.md): Prepare background-sound settings and distinguish ambient audio from tool-call sounds and speech recognition.
- [Voice design](https://docs.threetone.in/agents-platform/configure/voice-and-language/voice-design.md): Prepare a voice brief and review saved voices while a first-party voice-generation workflow remains planned.
- [Knowledge base](https://docs.threetone.in/agents-platform/configure/knowledge-base/overview.md): Create and organize knowledge documents, inspect their stored content, and review agent attachments and dependencies.
- [Manage documents](https://docs.threetone.in/agents-platform/configure/knowledge-base/manage-documents.md): Inspect, update, organize, and remove knowledge documents while checking current agent dependencies and stored content.
- [Retrieval-augmented generation](https://docs.threetone.in/agents-platform/configure/knowledge-base/rag.md): Prepare retrieval settings, inspect document indexes and chunks, and separate those checks from live knowledge-grounded answers.
- [Configure agent tools](https://docs.threetone.in/agents-platform/configure/tools/overview.md): Review workspace tool configuration, attach permitted tool identifiers to an agent, and keep credentials and action boundaries separate.
- [Client tools](https://docs.threetone.in/agents-platform/configure/tools/client-tools.md): Create a client-tool definition in the dashboard, review its parameters and response policy, and attach it to an agent draft.
- [Webhook tools](https://docs.threetone.in/agents-platform/configure/tools/webhook-tools.md): Define a reviewed HTTP action, configure its request schema and credential references, and inspect the saved dashboard tool.
- [Code tools](https://docs.threetone.in/agents-platform/configure/tools/code-tools.md): Prepare functions for future tool integration while hosted code execution remains planned.
- [MCP tools](https://docs.threetone.in/agents-platform/configure/tools/mcp-tools.md): Review MCP server and tool references, prepare input and approval policies, and track the separate discovery and execution requirements.
- [MCP security](https://docs.threetone.in/agents-platform/configure/tools/mcp-security.md): Review MCP operators, credential scope, and stored approval policies while discovery and runtime enforcement remain unavailable.
- [System tools](https://docs.threetone.in/agents-platform/configure/tools/system-tools.md): Review built-in conversation-control tool contracts and prepare their conditions without assuming live transfer or telephony support.
- [End call](https://docs.threetone.in/agents-platform/configure/tools/system-tools/end-call.md): Author when an agent should end a conversation and inspect the stored end-call definition without assuming a live hangup path.
- [Language detection](https://docs.threetone.in/agents-platform/configure/tools/system-tools/language-detection.md): Prepare the language-detection tool and its early-conversation policy while keeping ASR, response language, and live switching separate.
- [Agent transfer](https://docs.threetone.in/agents-platform/configure/tools/system-tools/agent-transfer.md): Prepare transfer rules with reviewed agent or workflow-node destinations and inspect their saved configuration.
- [Transfer to number](https://docs.threetone.in/agents-platform/configure/tools/system-tools/transfer-to-number.md): Prepare phone or SIP transfer destinations, conditions, and optional handoff settings without assuming telephony execution.
- [Skip turn](https://docs.threetone.in/agents-platform/configure/tools/system-tools/skip-turn.md): Prepare when an agent should avoid an unnecessary reply and distinguish that instruction from silence timers and call termination.
- [Keypad tones](https://docs.threetone.in/agents-platform/configure/tools/system-tools/keypad-tones.md): Prepare DTMF tool preferences and distinguish generated keypad tones from caller input and transfer extension settings.
- [Voicemail](https://docs.threetone.in/agents-platform/configure/tools/system-tools/voicemail.md): Prepare a voicemail-detection definition and optional message without assuming outbound calls, detection, or message delivery.
- [Update state](https://docs.threetone.in/agents-platform/configure/tools/system-tools/update-state.md): Plan how conversation values should change and use existing placeholder or assignment configuration without inventing a built-in state tool.
- [Flag an issue](https://docs.threetone.in/agents-platform/configure/tools/system-tools/flag-issue.md): Prepare an issue-review process and use existing conversation tags or feedback without assuming an automatic issue-flagging tool.
- [Tool execution](https://docs.threetone.in/agents-platform/configure/tools/tool-execution.md): Review authored timing, interruption, and error settings while keeping configuration checks separate from live execution evidence.
- [Tool sounds](https://docs.threetone.in/agents-platform/configure/tools/tool-sounds.md): Prepare stored sound and timing preferences for tool calls while sound previews and live playback remain planned.
- [Tool interruptions](https://docs.threetone.in/agents-platform/configure/tools/tool-interruptions.md): Review the authored interruption window for a tool and distinguish it from cancellation, execution timing, and first-message behavior.
- [Dynamic variables](https://docs.threetone.in/agents-platform/configure/personalization/dynamic-variables.md): Add named variables to an agent prompt, preserve typed placeholder values in a draft, and review eligible publication.
- [Overrides](https://docs.threetone.in/agents-platform/configure/personalization/overrides.md): Prepare a narrow policy for caller-supplied conversation settings and distinguish permission flags from override values.
- [Twilio personalization](https://docs.threetone.in/agents-platform/configure/personalization/twilio.md): Plan caller-specific context for a Twilio channel while keeping identity checks, private data, and conversation permissions separate.
- [Access and credentials](https://docs.threetone.in/agents-platform/configure/authentication/overview.md): Separate API keys, dashboard sessions, provider credentials, and conversation access when preparing an agent integration.
- [Auth connections](https://docs.threetone.in/agents-platform/configure/authentication/auth-connections.md): Create reusable workspace authentication configuration, reference it from supported fields, and review safe credential changes.
- [Workspace secrets](https://docs.threetone.in/agents-platform/configure/authentication/secrets.md): Store a private workspace value, use its identifier in supported configuration, and review dependencies before replacement or removal.
- [Integrations](https://docs.threetone.in/agents-platform/configure/integrations/overview.md): Choose a native provider connection, a custom MCP server, or a webhook tool, then review its credentials and agent attachment.
- [Cal.com](https://docs.threetone.in/agents-platform/configure/integrations/calcom.md): Prepare a Cal.com API-key connection, create selected integration tools, and review their saved agent attachment.
- [Calendly](https://docs.threetone.in/agents-platform/configure/integrations/calendly.md): Review the planned Calendly connection method and the prerequisites for a future scheduling integration.
- [Cursor](https://docs.threetone.in/agents-platform/configure/integrations/cursor.md): Plan a reviewed IDE workflow for inspecting Threetone configuration without assuming a hosted management server.
- [Custom channel](https://docs.threetone.in/agents-platform/configure/integrations/custom-channel.md): Define identity, routing, delivery, and failure requirements for an application-owned conversation channel.
- [Exa](https://docs.threetone.in/agents-platform/configure/integrations/exa.md): Prepare a bounded public-web research action with source URLs, limited queries, and explicit failure results.
- [Freshdesk](https://docs.threetone.in/agents-platform/configure/integrations/freshdesk.md): Prepare ticket lookup and reviewed support-note actions with account permissions and clear reply visibility.
- [Genesys](https://docs.threetone.in/agents-platform/configure/integrations/genesys.md): Prepare contact-center context and handoff requirements without assuming a live media or transfer integration.
- [Google Calendar](https://docs.threetone.in/agents-platform/configure/integrations/google-calendar.md): Prepare availability lookup and separately confirmed booking with narrow calendar access and timezone review.
- [Google Drive](https://docs.threetone.in/agents-platform/configure/integrations/google-drive.md): Prepare selected-document access and knowledge import with explicit permissions, provenance, and removal rules.
- [HubSpot](https://docs.threetone.in/agents-platform/configure/integrations/hubspot.md): Prepare CRM context lookup and reviewed property updates with account-specific authorization and record matching.
- [Intercom](https://docs.threetone.in/agents-platform/configure/integrations/intercom.md): Prepare conversation lookup and reviewed support replies with appropriate OAuth and audience controls.
- [Jira](https://docs.threetone.in/agents-platform/configure/integrations/jira.md): Prepare issue drafts and reviewed updates with project permissions, precise targets, and duplicate prevention.
- [Parallel](https://docs.threetone.in/agents-platform/configure/integrations/parallel.md): Prepare a bounded web-research action with a clear objective, attributable evidence, and incomplete-result handling.
- [Perplexity](https://docs.threetone.in/agents-platform/configure/integrations/perplexity.md): Prepare a source-search action while keeping search results separate from model configuration and runtime support.
- [Salesforce](https://docs.threetone.in/agents-platform/configure/integrations/salesforce.md): Prepare CRM reads and reviewed updates with organization, object, and field boundaries.
- [ServiceNow](https://docs.threetone.in/agents-platform/configure/integrations/servicenow.md): Prepare incident lookup and reviewed work notes with instance-specific authentication and access controls.
- [Slack](https://docs.threetone.in/agents-platform/configure/integrations/slack.md): Prepare a reviewed escalation message with narrow posting permissions and an exact channel or thread destination.
- [Tavily](https://docs.threetone.in/agents-platform/configure/integrations/tavily.md): Prepare focused public-web search with source evidence, bounded content, and explicit quota handling.
- [Telegram](https://docs.threetone.in/agents-platform/configure/integrations/telegram.md): Prepare a bot channel with authenticated updates, explicit chat routing, and duplicate-message handling.
- [Twilio](https://docs.threetone.in/agents-platform/configure/integrations/twilio.md): Review existing Twilio phone configuration and prepare messaging or call workflows with clear runtime and webhook boundaries.
- [Zendesk](https://docs.threetone.in/agents-platform/configure/integrations/zendesk.md): Prepare ticket lookup and reviewed internal notes using the current OAuth model and explicit comment visibility.
- [MCP servers](https://docs.threetone.in/agents-platform/configure/integrations/mcp-servers.md): Save a reviewed MCP endpoint and credential reference, configure approval intent, and attach the server to an agent version.
- [Prepare an integration](https://docs.threetone.in/agents-platform/deploy/overview.md): Prepare credentials, environment values, configuration versions, and phone resources before a supported runtime integration is released.
- [Environment variables](https://docs.threetone.in/agents-platform/deploy/environment-variables.md): Manage workspace values and credential references, understand production fallback, and verify environment-specific configuration.
- [Web deployment](https://docs.threetone.in/agents-platform/deploy/web/overview.md): Prepare browser session access, interface lifecycle, and hosting requirements before a supported widget release.
- [Widget](https://docs.threetone.in/agents-platform/deploy/web/widget.md): Prepare widget appearance, access, and browser acceptance checks before installing a supported production embed.
- [React SDK](https://docs.threetone.in/agents-platform/deploy/web/react.md): Prepare a React integration with server-owned access, explicit session ownership, and cleanup while the public SDK release is pending.
- [JavaScript SDK](https://docs.threetone.in/agents-platform/deploy/web/javascript.md): Prepare a framework-independent browser integration with explicit initialization, event cleanup, and supported session access.
- [React components](https://docs.threetone.in/agents-platform/deploy/web/react-components.md): Design accessible agent controls and transcript states while the public component package and client transport remain pending.
- [Mobile deployment](https://docs.threetone.in/agents-platform/deploy/mobile/overview.md): Prepare mobile session access, audio permissions, app lifecycle, and recovery behavior for a future client release.
- [React Native](https://docs.threetone.in/agents-platform/deploy/mobile/react-native.md): Prepare a React Native agent interface with a server-owned access boundary, permission handling, and device release checks.
- [Kotlin SDK for Android](https://docs.threetone.in/agents-platform/deploy/mobile/kotlin.md): Prepare Android session ownership, microphone permission, lifecycle behavior, and device checks before a supported Kotlin SDK release.
- [Swift SDK for iOS](https://docs.threetone.in/agents-platform/deploy/mobile/swift.md): Prepare an iOS agent interface with protected server access, microphone disclosure, scene lifecycle, and device acceptance checks.
- [Server integrations](https://docs.threetone.in/agents-platform/deploy/server/overview.md): Prepare server-side API access, resource identity, request handling, and deployment verification.
- [WebSockets](https://docs.threetone.in/agents-platform/deploy/server/websockets.md): Define the authorization, event contract, reconnect behavior, and operational checks required for a future WebSocket integration.
- [Phone integration](https://docs.threetone.in/agents-platform/deploy/telephony/overview.md): Review provider-backed phone number configuration, agent assignments, and the current limits of outbound and channel execution.
- [SIP trunk](https://docs.threetone.in/agents-platform/deploy/telephony/sip-trunk.md): Prepare SIP routing details, save a trunk configuration, and separate stored settings from a verified calling deployment.
- [SIP reference](https://docs.threetone.in/agents-platform/deploy/telephony/sip-reference.md): Map inbound and outbound SIP fields to a carrier review, and distinguish saved configuration from negotiated call behavior.
- [Customize calls](https://docs.threetone.in/agents-platform/deploy/telephony/customize-calls.md): Set the agent, branch, and environment associated with a phone number and verify the saved routing configuration.
- [Twilio native integration](https://docs.threetone.in/agents-platform/deploy/telephony/twilio/native-integration.md): Prepare the supported Twilio phone import and identify the credential, routing, and execution checks required before calling.
- [Twilio with a custom model](https://docs.threetone.in/agents-platform/deploy/telephony/twilio/custom-model-integration.md): Review the separate model, speech, and telephony contracts required for a future Twilio deployment with a custom language model.
- [Twilio SMS conversations](https://docs.threetone.in/agents-platform/deploy/telephony/twilio/sms-conversations.md): Prepare message routing, identity, retries, and delivery handling for a future SMS channel without enabling unsupported workspace routing.
- [Twilio regional routing](https://docs.threetone.in/agents-platform/deploy/telephony/twilio/regional-routing.md): Prepare region-specific Twilio credentials and edge choices while distinguishing accepted configuration from deployed routing.
- [Register a Twilio call](https://docs.threetone.in/agents-platform/deploy/telephony/twilio/register-call.md): Understand the current register-call response and prepare a future call handoff without configuring an unavailable webhook.
- [Twilio SMS verification](https://docs.threetone.in/agents-platform/deploy/telephony/twilio/sms-verification.md): Distinguish the website demo's phone verification from workspace SMS, and prepare bounded code verification and failure handling.
- [Provider integrations](https://docs.threetone.in/agents-platform/deploy/telephony/provider-integrations.md): Prepare Twilio, Exotel, or SIP import fields and understand the provider checks that remain outside a saved phone record.
- [Vonage](https://docs.threetone.in/agents-platform/deploy/telephony/providers/vonage.md): Prepare a Vonage SIP trunk, its regional domain, and authentication details for a future reviewed Threetone route.
- [Telnyx](https://docs.threetone.in/agents-platform/deploy/telephony/providers/telnyx.md): Map Telnyx SIP Connections, number assignments, and Outbound Voice Profiles into a future telephony deployment review.
- [Plivo](https://docs.threetone.in/agents-platform/deploy/telephony/providers/plivo.md): Prepare Plivo Zentrunk inbound and outbound configuration, authentication, and fallback destinations for a future SIP route.
- [Exotel](https://docs.threetone.in/agents-platform/deploy/telephony/providers/exotel.md): Prepare Exotel account, region, and applet fields for phone import while identifying the current outbound execution limit.
- [Bandwidth](https://docs.threetone.in/agents-platform/deploy/telephony/providers/bandwidth.md): Identify the Bandwidth platform and SIP routing objects before preparing a future Threetone carrier integration.
- [Sinch](https://docs.threetone.in/agents-platform/deploy/telephony/providers/sinch.md): Prepare Sinch Elastic SIP Trunking identity, number assignment, and outbound settings for a future supported calling route.
- [Amazon Connect](https://docs.threetone.in/agents-platform/deploy/telephony/contact-center/amazon-connect.md): Prepare an Amazon Connect external-transfer design, destination ownership, and fallback behavior for a future agent integration.
- [Genesys Cloud](https://docs.threetone.in/agents-platform/deploy/telephony/contact-center/genesys.md): Review Genesys Cloud transfer and BYOC Cloud boundaries before preparing a future Threetone telephony integration.
- [Five9](https://docs.threetone.in/agents-platform/deploy/telephony/contact-center/five9.md): Prepare Five9 VoiceStream destinations and event correlation while separating audio observation from an active agent call integration.
- [Microsoft Teams](https://docs.threetone.in/agents-platform/deploy/telephony/microsoft-teams/overview.md): Choose between a Teams tab, Azure Communication Services, and a Graph media bot when preparing a future integration.
- [Teams widget tab](https://docs.threetone.in/agents-platform/deploy/telephony/microsoft-teams/widget-tab.md): Prepare an authenticated web experience for a Teams tab without assuming a public widget embed or access to meeting audio.
- [Azure Communication Services](https://docs.threetone.in/agents-platform/deploy/telephony/microsoft-teams/azure-communication-services.md): Choose an identity model and prepare a custom Teams interoperability application before adding an agent media integration.
- [Graph media bot](https://docs.threetone.in/agents-platform/deploy/telephony/microsoft-teams/graph-media-bot.md): Prepare Microsoft Graph application-hosted media requirements, instance lifecycle, and agent boundaries for a future Teams bot.
- [Telephony troubleshooting](https://docs.threetone.in/agents-platform/deploy/telephony/troubleshooting.md): Isolate import, assignment, runtime, and provider failures without treating a saved phone number as a successful call.
- [WhatsApp](https://docs.threetone.in/agents-platform/deploy/whatsapp/overview.md): Prepare a WhatsApp Business account connection, review phone registration and agent assignment, and understand planned messaging and calling.
- [Connect an account](https://docs.threetone.in/agents-platform/deploy/whatsapp/connect-account.md): Use the enabled Meta authorization workflow to connect a WhatsApp Business account, inspect registration, and review saved settings.
- [Messaging and calls](https://docs.threetone.in/agents-platform/deploy/whatsapp/messaging-and-calls.md): Prepare WhatsApp messaging and calling requirements without treating account setup or saved preferences as released execution.
- [Outbound messages and calls](https://docs.threetone.in/agents-platform/deploy/whatsapp/outbound.md): Prepare recipient, template, and call-permission data while distinguishing the public request contract from unavailable delivery.
- [Interactive messages](https://docs.threetone.in/agents-platform/deploy/whatsapp/interactive-messages.md): Prepare reply choices and template buttons with stable identifiers and clear limits on the current WhatsApp schema.
- [Tools in WhatsApp conversations](https://docs.threetone.in/agents-platform/deploy/whatsapp/tools.md): Prepare narrowly scoped actions for a future WhatsApp channel without confusing sender identity, tool access, and confirmation.
- [WhatsApp troubleshooting](https://docs.threetone.in/agents-platform/deploy/whatsapp/troubleshooting.md): Separate account setup, authorization, registration, saved preferences, and unavailable execution when diagnosing a WhatsApp issue.
- [Batch calls](https://docs.threetone.in/agents-platform/deploy/batch-calls.md): Prepare a controlled batch-calling plan and inspect the release requirements before submitting work.
- [Review agent activity](https://docs.threetone.in/agents-platform/monitor/overview.md): Inspect saved conversations, trace configuration versions, and turn observed problems into reviewable agent changes.
- [Inspect conversations](https://docs.threetone.in/agents-platform/monitor/conversations.md): List saved conversation records, inspect transcripts and summaries, and retrieve audio when a recording is available.
- [Conversation users](https://docs.threetone.in/agents-platform/monitor/users.md): Find end users represented in saved conversations and inspect their contact history through the API.
- [Agent testing](https://docs.threetone.in/agents-platform/monitor/testing.md): Author reusable response, tool-call, and simulation test definitions while tracking the separate execution gate.
- [Experiments](https://docs.threetone.in/agents-platform/monitor/experiments.md): Prepare a controlled agent comparison with a fixed scenario set, version references, and explicit release criteria.
- [Versions and drafts](https://docs.threetone.in/agents-platform/deploy/versioning.md): Use explicit branches, review draft snapshots, and publish identifiable agent configuration versions without confusing them with deployment.
- [Merge proposals](https://docs.threetone.in/agents-platform/monitor/merge-proposals.md): Review a branch merge preview and prepare an approval record without assuming a proposal-management workflow.
- [Conversation analysis](https://docs.threetone.in/agents-platform/monitor/analysis/overview.md): Configure evaluation and data collection, then inspect analysis already stored with conversation records.
- [Success evaluation](https://docs.threetone.in/agents-platform/monitor/analysis/success-evaluation.md): Author precise outcome criteria and interpret saved evaluation results without treating configuration as execution.
- [Data collection](https://docs.threetone.in/agents-platform/monitor/analysis/data-collection.md): Define primitive analysis fields and inspect values already stored with a conversation.
- [Sentiment analysis](https://docs.threetone.in/agents-platform/monitor/analysis/sentiment.md): Interpret existing sentiment aggregates while distinguishing them from planned sentiment generation.
- [Find conversations for review](https://docs.threetone.in/agents-platform/monitor/analysis/searching.md): Use supported conversation list filters while text and semantic message search remain unavailable.
- [Analytics](https://docs.threetone.in/agents-platform/monitor/analytics.md): Interpret dashboard analytics with consistent filters and distinguish them from unavailable public workspace reports.
- [Insights](https://docs.threetone.in/agents-platform/monitor/insights/overview.md): Turn saved conversations and available analytics into reviewable findings with a clear sample, source, and follow-up.
- [Real-time insights](https://docs.threetone.in/agents-platform/monitor/insights/real-time-insights.md): Interpret the current workspace live counter and prepare freshness, access, and event requirements for future live insights.
- [Conversation topics](https://docs.threetone.in/agents-platform/monitor/topics.md): Plan a useful topic taxonomy and understand the current limits of automated topic discovery.
- [Real-time monitoring](https://docs.threetone.in/agents-platform/monitor/real-time-monitoring.md): Read the workspace live counter and distinguish it from unreleased event streams and live conversation monitoring.
- [OpenTelemetry](https://docs.threetone.in/agents-platform/monitor/opentelemetry.md): Request stored trace payloads with conversation details and plan instrumentation without assuming an exporter exists.
- [Conversation privacy](https://docs.threetone.in/agents-platform/monitor/privacy/overview.md): Review saved privacy preferences and distinguish configuration from implemented storage and deletion behavior.
- [Retention settings](https://docs.threetone.in/agents-platform/monitor/privacy/retention.md): Record retention intent and understand the limits of automatic deletion and historical cleanup.
- [Audio and redaction](https://docs.threetone.in/agents-platform/monitor/privacy/audio-and-redaction.md): Review audio and redaction preferences without assuming recording suppression or PII removal is enforced.
- [Zero retention](https://docs.threetone.in/agents-platform/monitor/privacy/zero-retention.md): Record a zero-retention requirement while tracking the enforcement and provider checks needed before relying on it.
- [Cost optimization](https://docs.threetone.in/agents-platform/monitor/cost-optimization.md): Prepare measurable cost changes using model selection, context limits, and consistent historical evidence.
- [Command-line workflows](https://docs.threetone.in/agents-platform/monitor/cli.md): Use public API examples from a terminal while tracking the unreleased Threetone product CLI.
- [Hosted MCP](https://docs.threetone.in/agents-platform/monitor/hosted-mcp.md): Distinguish external MCP server registration from a future first-party agent-management MCP service.
- [Conversation triage](https://docs.threetone.in/agents-platform/monitor/triage.md): Create API-backed review tickets, attach transcript evidence, and assign a responsible workspace member.
- [Advanced configuration](https://docs.threetone.in/agents-platform/advanced/overview.md): Review event selections, custom model endpoints, model fallback, and post-call notification configuration.
- [Events](https://docs.threetone.in/agents-platform/advanced/events/overview.md): Distinguish client events, monitoring selections, and post-call notifications before designing an integration.
- [Client events](https://docs.threetone.in/agents-platform/advanced/events/client-events.md): Prepare client event selections and UI handling without assuming a released conversation transport.
- [Client-to-server context](https://docs.threetone.in/agents-platform/advanced/events/client-to-server.md): Plan typed conversation context and action boundaries for a future supported client transport.
- [Custom models](https://docs.threetone.in/agents-platform/advanced/custom-models/overview.md): Prepare a custom language-model endpoint, run the supported dashboard connection probe, and preserve a candidate configuration as a draft.
- [Endpoint compatibility](https://docs.threetone.in/agents-platform/advanced/custom-models/compatible-endpoints.md): Review the supported custom-model probe format, URL shape, credential references, and provider compatibility.
- [Cloudflare Workers AI](https://docs.threetone.in/agents-platform/advanced/custom-models/cloudflare.md): Prepare a Cloudflare Workers AI Chat Completions candidate and test it through the supported custom-model connection probe.
- [Groq](https://docs.threetone.in/agents-platform/advanced/custom-models/groq.md): Prepare a Groq chat model, protected API-key reference, and streaming connection probe without assuming runtime compatibility.
- [SambaNova](https://docs.threetone.in/agents-platform/advanced/custom-models/sambanova.md): Prepare a SambaNova cloud Chat Completions candidate and review endpoint, model, and streaming behavior before saving a draft.
- [Together AI](https://docs.threetone.in/agents-platform/advanced/custom-models/together-ai.md): Prepare a Together AI chat-model candidate and verify the endpoint, model identifier, and streaming connection probe.
- [LLM cascading](https://docs.threetone.in/agents-platform/advanced/llm-cascading.md): Configure managed model fallback policy, backup order, and timeout, then inspect the saved configuration.
- [Post-call webhooks](https://docs.threetone.in/agents-platform/advanced/post-call-webhooks.md): Review persisted notification preferences and prepare a receiver without assuming webhook resource storage or delivery is released.
- [Developer resources](https://docs.threetone.in/agents-platform/resources/overview.md): Find language client guidance, UI integration preparation, and the public API contract.
- [SDKs](https://docs.threetone.in/agents-platform/resources/sdks/overview.md): Check Threetone SDK availability and use Python or TypeScript REST examples to read agent records.
- [Python SDK](https://docs.threetone.in/agents-platform/resources/sdks/python.md): Check planned Python SDK availability and read Threetone agent records with a validated Requests example.
- [TypeScript SDK](https://docs.threetone.in/agents-platform/resources/sdks/typescript.md): Check planned TypeScript SDK availability and read Threetone agent records with Node.js fetch and response validation.
- [UI components](https://docs.threetone.in/agents-platform/resources/ui-components.md): Prepare a conversation interface while the public Threetone component and client transport contracts are being established.
- [Implementation guides](https://docs.threetone.in/agents-platform/guides/overview.md): Choose a practical setup guide for API integrations, web experiences, conversation review, and planned channel workflows.
- [Next.js preparation](https://docs.threetone.in/agents-platform/guides/nextjs.md): Separate server-side workspace API access from browser interaction when preparing a Next.js agent experience.
- [JavaScript preparation](https://docs.threetone.in/agents-platform/guides/quickstarts/javascript.md): Prepare a browser interface with an authorized server boundary, safe environment variables, and a clear integration lifecycle.
- [Server-side quickstart](https://docs.threetone.in/agents-platform/guides/quickstarts/server-side.md): Verify server-side authentication, list accessible agents, and inspect a selected configuration with the public API.
- [Chat mode](https://docs.threetone.in/agents-platform/guides/chat-mode.md): Prepare a text-only agent configuration, choose a managed response model, and separate publication from live chat availability.
- [Burst pricing](https://docs.threetone.in/agents-platform/guides/burst-pricing.md): Separate planned burst-capacity charges from subscription allowances and verify approved commercial terms before launch.
- [Call queueing](https://docs.threetone.in/agents-platform/guides/call-queueing.md): Define admission, waiting, expiry, and cancellation behavior for a future supported call queue.
- [Documentation assistant](https://docs.threetone.in/agents-platform/guides/documentation-assistant.md): Prepare an agent that answers from reviewed product documentation, identifies unsupported questions, and links users to the right source.
- [User interviews](https://docs.threetone.in/agents-platform/guides/scaling-user-interviews.md): Plan a consistent research interview, consent process, data collection, and human review before scaling agent-assisted sessions.
- [Simulate conversations](https://docs.threetone.in/agents-platform/guides/simulate-conversations.md): Define representative conversation simulations, expected outcomes, and review criteria before automated execution is released.
- [No-code websites](https://docs.threetone.in/agents-platform/guides/no-code/overview.md): Prepare a website placement, content policy, and launch checklist for a future supported Threetone embed.
- [Ghost](https://docs.threetone.in/agents-platform/guides/no-code/ghost.md): Prepare a Ghost publication for a future Threetone widget, with a deliberate injection scope and published-site checks.
- [Framer](https://docs.threetone.in/agents-platform/guides/no-code/framer.md): Plan a Framer embed with a suitable layout, permitted hosting origin, and explicit checks before a Threetone widget release.
- [Squarespace](https://docs.threetone.in/agents-platform/guides/no-code/squarespace.md): Prepare Squarespace code-injection scope and published-page checks for a future supported Threetone widget.
- [Webflow](https://docs.threetone.in/agents-platform/guides/no-code/webflow.md): Prepare a Webflow page for a future supported agent embed and define staging, accessibility, and security checks.
- [Wix](https://docs.threetone.in/agents-platform/guides/no-code/wix.md): Prepare a Wix HTML or site embed and review frame, sizing, and access requirements before a supported widget release.
- [WordPress](https://docs.threetone.in/agents-platform/guides/no-code/wordpress.md): Prepare a WordPress placement for a future Threetone embed while preserving credential safety and a reviewable release path.
- [Expo and React Native](https://docs.threetone.in/agents-platform/guides/cookbooks/expo-react-native.md): Prepare a mobile client with explicit microphone permissions, server-owned credentials, and lifecycle-aware connection handling.
- [Live avatar](https://docs.threetone.in/agents-platform/guides/cookbooks/live-avatar.md): Prepare an avatar presentation layer with separate session ownership, media contracts, interruption, and cleanup requirements.
- [Raspberry Pi](https://docs.threetone.in/agents-platform/guides/cookbooks/raspberry-pi.md): Prepare a controlled device prototype with tested audio, restricted credentials, and explicit offline and restart behavior.
- [Redis context](https://docs.threetone.in/agents-platform/guides/cookbooks/redis-context.md): Design an application-owned context cache with identity isolation, expiration, and predictable failure behavior.
- [Legal review](https://docs.threetone.in/agents-platform/legal/overview.md): Prepare a deployment review covering consent, AI disclosure, sensitive data, applicable agreements, and Threetone's current policies.
- [Call consent and recording](https://docs.threetone.in/agents-platform/legal/call-consent.md): Prepare a calling review that separates contact permission, artificial-voice requirements, recording decisions, and requests to stop contact.
- [AI identity and disclosure](https://docs.threetone.in/agents-platform/legal/ai-disclosure.md): Review how an agent identifies the business, explains its use of AI, describes its abilities, and responds when someone requests human help.
- [Healthcare deployment review](https://docs.threetone.in/agents-platform/legal/healthcare.md): Assess a proposed healthcare workflow, its data flows, required agreements, safeguards, and service suitability before introducing patient information.
- [API overview](https://docs.threetone.in/api-reference/introduction.md): Use the Threetone API to manage Agents Platform resources and shared workspace configuration.
- [Authentication](https://docs.threetone.in/api-reference/authentication.md): Authenticate Threetone API requests with a scoped API key in the x-api-key header.
- [Errors and retries](https://docs.threetone.in/api-reference/errors.md): Read Threetone API error responses, retain request IDs, and retry only transient failures.
- [List agent branches](https://docs.threetone.in/api-reference/agents-platform/list-agent-branches.md): Returns a list of branches an agent has
- [Create agent branch](https://docs.threetone.in/api-reference/agents-platform/create-agent-branch.md): Create a new branch from a given version of any branch
- [Get agent branch](https://docs.threetone.in/api-reference/agents-platform/get-agent-branch.md): Get information about a single agent branch
- [Update agent branch](https://docs.threetone.in/api-reference/agents-platform/update-agent-branch.md): Update agent branch properties such as archiving status and protection level
- [Merge agent branch](https://docs.threetone.in/api-reference/agents-platform/merge-agent-branch.md): Merge a branch into a target branch
- [Preview merged configuration](https://docs.threetone.in/api-reference/agents-platform/preview-merged-configuration.md): Returns the result of merging the source branch into the target branch without performing the merge. Useful for showing an accurate diff before confirming
- [Preview rebased configuration](https://docs.threetone.in/api-reference/agents-platform/preview-rebased-configuration.md): Returns the result of rebasing the branch onto main without performing the rebase. Useful for showing an accurate diff before confirming
- [Rebase agent branch onto main](https://docs.threetone.in/api-reference/agents-platform/rebase-agent-branch-onto-main.md): Rebase a branch onto the latest main branch, incorporating main's changes while preserving the branch's own changes
- [List procedures](https://docs.threetone.in/api-reference/agents-platform/list-procedures.md): List an agent branch's procedures and draft status. Use the procedure detail endpoint to retrieve content
- [Create procedure](https://docs.threetone.in/api-reference/agents-platform/create-procedure.md): Create a new procedure for the agent on a branch
- [Compile procedures](https://docs.threetone.in/api-reference/agents-platform/compile-procedures.md): Compile procedure drafts into a workflow
- [Get procedure](https://docs.threetone.in/api-reference/agents-platform/get-procedure.md): Retrieve a procedure at a specific version or the current branch HEAD
- [Delete procedure](https://docs.threetone.in/api-reference/agents-platform/delete-procedure.md): Remove a procedure from the agent's draft working set
- [Get procedure draft](https://docs.threetone.in/api-reference/agents-platform/get-procedure-draft.md): Get user's draft for a procedure
- [Update procedure draft](https://docs.threetone.in/api-reference/agents-platform/update-procedure-draft.md): Create or update user's draft for a procedure
- [Delete procedure draft](https://docs.threetone.in/api-reference/agents-platform/delete-procedure-draft.md): Delete user's draft for a procedure, resetting to the committed version
- [Create or update agent deployments](https://docs.threetone.in/api-reference/agents-platform/create-or-update-agent-deployments.md): Create a new deployment for an agent
- [Create agent draft](https://docs.threetone.in/api-reference/agents-platform/create-agent-draft.md): Create a new draft for an agent
- [Delete agent draft](https://docs.threetone.in/api-reference/agents-platform/delete-agent-draft.md): Delete a draft for an agent
- [Get agent version metadata](https://docs.threetone.in/api-reference/agents-platform/get-agent-version-metadata.md): Get metadata for a specific agent version
- [Get agent widget configuration](https://docs.threetone.in/api-reference/agents-platform/get-agent-widget-configuration.md): Retrieve the widget configuration for an agent
- [Upload agent avatar](https://docs.threetone.in/api-reference/agents-platform/upload-agent-avatar.md): Sets the avatar for an agent displayed in the widget
- [Post Agent Hold Audio](https://docs.threetone.in/api-reference/agents-platform/post-agent-hold-audio.md): Sets the custom hold audio played on loop to callers waiting in the agent's concurrency wait queue. Replaces any previously uploaded clip.
- [Delete Agent Hold Audio](https://docs.threetone.in/api-reference/agents-platform/delete-agent-hold-audio.md): Removes the agent's custom hold audio; queued callers hear the default hold tone again.
- [Create agent](https://docs.threetone.in/api-reference/agents-platform/create-agent.md): Create an agent from a config object
- [Duplicate agent](https://docs.threetone.in/api-reference/agents-platform/duplicate-agent.md): Create a new agent by duplicating an existing one
- [Get shareable agent link](https://docs.threetone.in/api-reference/agents-platform/get-shareable-agent-link.md): Get the current link used to share the agent with others
- [List agent summaries](https://docs.threetone.in/api-reference/agents-platform/list-agent-summaries.md): Returns summaries for the specified agents
- [List agents](https://docs.threetone.in/api-reference/agents-platform/list-agents.md): Returns a list of your agents and their metadata
- [Get agent](https://docs.threetone.in/api-reference/agents-platform/get-agent.md): Retrieve config for an agent
- [Update agent](https://docs.threetone.in/api-reference/agents-platform/update-agent.md): Patches an Agent settings
- [Delete agent](https://docs.threetone.in/api-reference/agents-platform/delete-agent.md): Delete an agent
- [Run conversation analysis](https://docs.threetone.in/api-reference/agents-workspace-analytics/run-conversation-analysis.md): Run the analysis for a conversation using the agent's current evaluation criteria and data collection settings.
- [Run conversation evaluation](https://docs.threetone.in/api-reference/agents-workspace-analytics/run-conversation-evaluation.md): Rerun a specific evaluation for a conversation.
- [Text search](https://docs.threetone.in/api-reference/agents-platform/text-search.md): Search through conversation transcript messages by full-text and fuzzy search
- [Smart search](https://docs.threetone.in/api-reference/agents-platform/smart-search.md): Search conversation transcripts by semantic similarity to surface relevant messages based on meaning and intent, rather than exact keyword matches
- [Get agent conversation topics](https://docs.threetone.in/api-reference/agents-insights/get-agent-conversation-topics.md): Returns the latest topic discovery run results for a given agent.
- [List tags](https://docs.threetone.in/api-reference/agents-platform/list-tags.md): List conversation tags for the workspace, ordered by most recently created first.
- [Create tag](https://docs.threetone.in/api-reference/agents-platform/create-tag.md): Create a new conversation tag for the workspace.
- [Get tag](https://docs.threetone.in/api-reference/agents-platform/get-tag.md): Get a conversation tag by ID.
- [Update tag](https://docs.threetone.in/api-reference/agents-platform/update-tag.md): Update a conversation tag's title and/or description. Restricted to the tag owner or a workspace admin.
- [Delete tag](https://docs.threetone.in/api-reference/agents-platform/delete-tag.md): Delete a conversation tag. Restricted to the tag owner or a workspace admin.
- [Add tag to conversation](https://docs.threetone.in/api-reference/agents-platform/add-tag-to-conversation.md): Assign one or more conversation tags to a conversation. Tags that are already assigned are ignored. Tags must belong to the same workspace.
- [Remove tag from conversation](https://docs.threetone.in/api-reference/agents-platform/remove-tag-from-conversation.md): Remove a single conversation tag from a conversation.
- [List conversations](https://docs.threetone.in/api-reference/agents-platform/list-conversations.md): Get all conversations of agents that user owns. With option to restrict to a specific agent.
- [Get conversation details](https://docs.threetone.in/api-reference/agents-platform/get-conversation-details.md): Get the details of a particular conversation
- [Get conversation summary](https://docs.threetone.in/api-reference/agents-platform/get-conversation-summary.md): Return a lightweight conversation summary without tool calls, tool results, or contextual updates. Use the conversation details endpoint for the full transcript
- [Delete conversation](https://docs.threetone.in/api-reference/agents-platform/delete-conversation.md): Delete a particular conversation
- [Get conversation audio](https://docs.threetone.in/api-reference/agents-platform/get-conversation-audio.md): Get the audio recording of a particular conversation
- [Get signed URL](https://docs.threetone.in/api-reference/agents-platform/get-signed-url.md): Get a signed URL to start a conversation with an agent with an agent that requires authorization
- [Get conversation token](https://docs.threetone.in/api-reference/agents-platform/get-conversation-token.md): Get a WebRTC session token for real-time communication.
- [Send conversation feedback](https://docs.threetone.in/api-reference/agents-platform/send-conversation-feedback.md): Send the feedback for the given conversation
- [Upload conversation file](https://docs.threetone.in/api-reference/agents-platform/upload-conversation-file.md): Upload an image or PDF file for a conversation. Returns a unique file ID that can be used to reference the file in the conversation.
- [Delete conversation file](https://docs.threetone.in/api-reference/agents-platform/delete-conversation-file.md): Remove a file upload from a conversation. Only possible if the file hasn't already been used in the conversation.
- [Get SIP messages for a conversation](https://docs.threetone.in/api-reference/agents-platform/get-sip-messages-for-a-conversation.md): Get SIP messages associated with a conversation's phone call
- [Resolve conversation reference](https://docs.threetone.in/api-reference/agents-platform/resolve-conversation-reference.md): Resolve a supported Slack or Zendesk conversation URL to an existing Threetone conversation ID
- [List tests](https://docs.threetone.in/api-reference/tests/list-tests.md): Lists all agent response tests with pagination support and optional search filtering.
- [Get test](https://docs.threetone.in/api-reference/tests/get-test.md): Gets an agent response test by ID.
- [Create test](https://docs.threetone.in/api-reference/tests/create-test.md): Creates a new agent response test.
- [Update test](https://docs.threetone.in/api-reference/tests/update-test.md): Updates an agent response test by ID.
- [Delete test](https://docs.threetone.in/api-reference/tests/delete-test.md): Deletes an agent response test by ID.
- [Get test summaries](https://docs.threetone.in/api-reference/tests/get-test-summaries.md): Gets agent response test summaries for the requested test IDs.
- [Run tests on agent](https://docs.threetone.in/api-reference/tests/run-tests-on-agent.md): Run selected tests on the agent with provided configuration. If the agent configuration is provided, it will be used to override default agent configuration.
- [Create folder](https://docs.threetone.in/api-reference/test-folders/create-folder.md): Creates a folder for organizing agent tests.
- [Get folder](https://docs.threetone.in/api-reference/test-folders/get-folder.md): Gets an agent test folder by ID, including its folder path.
- [Update folder](https://docs.threetone.in/api-reference/test-folders/update-folder.md): Updates an agent test folder. Currently only supports updating the folder name.
- [Delete folder](https://docs.threetone.in/api-reference/test-folders/delete-folder.md): Deletes an agent test folder by ID. Use force=true to delete a non-empty folder and all its contents.
- [Bulk move tests to folder](https://docs.threetone.in/api-reference/test-folders/bulk-move-tests-to-folder.md): Moves multiple tests or folders from one folder to another.
- [Get test invocation](https://docs.threetone.in/api-reference/test-invocations/get-test-invocation.md): Gets a test invocation by ID.
- [Resubmit test invocation](https://docs.threetone.in/api-reference/test-invocations/resubmit-test-invocation.md): Resubmits specific test runs from a test invocation.
- [List test invocations](https://docs.threetone.in/api-reference/test-invocations/list-test-invocations.md): Lists all test invocations with pagination support and optional search filtering.
- [List Workspace Conversation Tickets](https://docs.threetone.in/api-reference/list-workspace-conversation-tickets.md): List conversation triage tickets across every agent the caller can access, newest first. Filter by status or assignee and use cursor pagination. For one agent's tickets, use the per-agent endpoint.
- [Create Agent Conversation Ticket](https://docs.threetone.in/api-reference/create-agent-conversation-ticket.md): Raise a ticket about an agent's performance on a conversation, for triage with Architect. Provide an overall comment and/or turn-level comments describing what went wrong.
- [List tickets](https://docs.threetone.in/api-reference/list-tickets.md): List an agent's conversation triage tickets, ordered newest first
- [Create manual ticket](https://docs.threetone.in/api-reference/create-manual-ticket.md): Manually raise a follow-up ticket against an agent, not tied to any conversation (for example a task like 'add the KB about X'). The comment is shown as the ticket title. Requires viewer access to the agent.
- [List assignable users](https://docs.threetone.in/api-reference/list-assignable-users.md): List workspace members who can be assigned to an agent conversation ticket, including members who still need access to the agent
- [Get ticket](https://docs.threetone.in/api-reference/get-ticket.md): Get an agent conversation ticket by ID
- [Update ticket](https://docs.threetone.in/api-reference/update-ticket.md): Update a ticket's comment, status, and/or assignee. Requires editor access to the ticket's agent
- [Delete ticket](https://docs.threetone.in/api-reference/delete-ticket.md): Delete an agent conversation ticket. Restricted to the ticket creator or a workspace admin
- [Add comment](https://docs.threetone.in/api-reference/add-comment.md): Append a comment discussing how to resolve the ticket. Requires viewer access to the ticket's agent
- [Add turn comment](https://docs.threetone.in/api-reference/add-turn-comment.md): Append a turn-level comment to a ticket. Requires viewer access to the ticket's agent
- [List conversation users](https://docs.threetone.in/api-reference/agents-platform/list-conversation-users.md): Get distinct users from conversations with pagination
- [List tools](https://docs.threetone.in/api-reference/agents-platform/list-tools.md): Get all available tools in the workspace
- [Create tool](https://docs.threetone.in/api-reference/agents-platform/create-tool.md): Add a new tool to the available tools in the workspace
- [Get tool](https://docs.threetone.in/api-reference/agents-platform/get-tool.md): Get tool that is available in the workspace
- [Update tool](https://docs.threetone.in/api-reference/agents-platform/update-tool.md): Update tool that is available in the workspace
- [Delete tool](https://docs.threetone.in/api-reference/agents-platform/delete-tool.md): Delete tool from the workspace
- [List tool executions](https://docs.threetone.in/api-reference/agents-platform/list-tool-executions.md): Get paginated list of tool executions for a specific tool
- [List agents using tool](https://docs.threetone.in/api-reference/agents-platform/list-agents-using-tool.md): Get a list of agents depending on this tool
- [List knowledge base documents](https://docs.threetone.in/api-reference/agents-platform/list-knowledge-base-documents.md): Get a list of available knowledge base documents
- [Create knowledge base document from URL](https://docs.threetone.in/api-reference/agents-platform/create-knowledge-base-document-from-url.md): Create a knowledge base document generated by scraping the given webpage
- [Create knowledge base document from file](https://docs.threetone.in/api-reference/agents-platform/create-knowledge-base-document-from-file.md): Create a knowledge base document generated form the uploaded file
- [Create knowledge base document from text](https://docs.threetone.in/api-reference/agents-platform/create-knowledge-base-document-from-text.md): Create a knowledge base document containing the provided text
- [Delete knowledge base documents](https://docs.threetone.in/api-reference/agents-platform/delete-knowledge-base-documents.md): Delete multiple documents or folders from the knowledge base. Each ID succeeds or fails independently
- [Get knowledge base document](https://docs.threetone.in/api-reference/agents-platform/get-knowledge-base-document.md): Get details about a specific documentation making up the agent's knowledge base
- [Update document](https://docs.threetone.in/api-reference/agents-platform/update-document.md): Update the name and/or content of a document
- [Delete knowledge base document or folder](https://docs.threetone.in/api-reference/agents-platform/delete-knowledge-base-document-or-folder.md): Delete a document or folder from the knowledge base
- [Replace knowledge base file](https://docs.threetone.in/api-reference/agents-platform/replace-knowledge-base-file.md): Replace a file document's source file, content, and metadata. This overwrites manual content edits
- [Refresh knowledge base URL](https://docs.threetone.in/api-reference/agents-platform/refresh-knowledge-base-url.md): Manually refresh a URL document by re-fetching its content from the source URL
- [Get knowledge base document content](https://docs.threetone.in/api-reference/agents-platform/get-knowledge-base-document-content.md): Get the entire content of a document from the knowledge base
- [Get knowledge base source file URL](https://docs.threetone.in/api-reference/agents-platform/get-knowledge-base-source-file-url.md): Get a signed URL to download the original source file of a file-type document from the knowledge base
- [Get knowledge base document chunk](https://docs.threetone.in/api-reference/agents-platform/get-knowledge-base-document-chunk.md): Get details about a specific documentation part used by RAG
- [List RAG chunks for document](https://docs.threetone.in/api-reference/agents-platform/list-rag-chunks-for-document.md): Get all RAG chunks for a specific knowledge base document
- [Create knowledge base folder](https://docs.threetone.in/api-reference/conversational-ai/create-knowledge-base-folder.md): Create a folder used for grouping documents together
- [Move knowledge base item](https://docs.threetone.in/api-reference/conversational-ai/move-knowledge-base-item.md): Moves the entity from one folder to another
- [Move knowledge base items](https://docs.threetone.in/api-reference/conversational-ai/move-knowledge-base-items.md): Moves multiple entities from one folder to another
- [Search knowledge base content](https://docs.threetone.in/api-reference/agents-platform/search-knowledge-base-content.md): Fuzzy text search over knowledge base document content
- [List knowledge base summaries](https://docs.threetone.in/api-reference/agents-platform/list-knowledge-base-summaries.md): Gets multiple knowledge base document summaries by their IDs
- [List agents using knowledge base document](https://docs.threetone.in/api-reference/agents-platform/list-agents-using-knowledge-base-document.md): Get a list of agents depending on this knowledge base document
- [List agents using knowledge base documents](https://docs.threetone.in/api-reference/agents-platform/list-agents-using-knowledge-base-documents.md): Get a list of agents depending on any of the given knowledge base documents
- [Get agent knowledge base size](https://docs.threetone.in/api-reference/agents-platform/get-agent-knowledge-base-size.md): Returns the number of pages in the agent's knowledge base
- [Get RAG index overview](https://docs.threetone.in/api-reference/agents-platform/get-rag-index-overview.md): Provides total size and other information of RAG indexes used by knowledgebase documents
- [Create RAG indexes](https://docs.threetone.in/api-reference/agents-platform/create-rag-indexes.md): Retrieves and/or creates RAG indexes for multiple knowledge base documents in a single request. Maximum 100 items per request
- [Get document RAG indexes](https://docs.threetone.in/api-reference/agents-platform/get-document-rag-indexes.md): Provides information about all RAG indexes of the specified knowledgebase document
- [Create document RAG index](https://docs.threetone.in/api-reference/agents-platform/create-document-rag-index.md): In case the document is not RAG indexed, it triggers RAG indexing task, otherwise it just returns the current status
- [Delete RAG index](https://docs.threetone.in/api-reference/agents-platform/delete-rag-index.md): Delete RAG index for the knowledgebase document
- [Query agent knowledge base](https://docs.threetone.in/api-reference/agents-platform/query-agent-knowledge-base.md): Run the agent's current RAG retrieval for an ad hoc query and return ranked chunks without creating a conversation
- [List crawl jobs](https://docs.threetone.in/api-reference/conversational-ai/list-crawl-jobs.md): Get a list of ongoing and recent crawl jobs for the user
- [Create crawl job](https://docs.threetone.in/api-reference/conversational-ai/create-crawl-job.md): Create a crawl job to crawl the given URL with the specified page limit
- [Get crawl job](https://docs.threetone.in/api-reference/conversational-ai/get-crawl-job.md): Get details about a specific crawl job including status and progress
- [Cancel crawl job](https://docs.threetone.in/api-reference/conversational-ai/cancel-crawl-job.md): Cancel a crawl job and delete all associated documents and folders
- [List phone numbers](https://docs.threetone.in/api-reference/agents-platform/list-phone-numbers.md): Retrieve all Phone Numbers
- [List Phone Numbers Page](https://docs.threetone.in/api-reference/agents-platform/list-phone-numbers-page.md): Retrieve a page of Phone Numbers
- [Import phone number](https://docs.threetone.in/api-reference/agents-platform/import-phone-number.md): Import Phone Number from provider configuration (Twilio, Exotel, or SIP trunk)
- [Get phone number](https://docs.threetone.in/api-reference/agents-platform/get-phone-number.md): Retrieve Phone Number details by ID
- [Update phone number](https://docs.threetone.in/api-reference/agents-platform/update-phone-number.md): Update assigned agent of a phone number
- [Delete phone number](https://docs.threetone.in/api-reference/agents-platform/delete-phone-number.md): Delete Phone Number by ID
- [Get SIP messages for a phone number](https://docs.threetone.in/api-reference/agents-platform/get-sip-messages-for-a-phone-number.md): Get SIP messages for a phone number
- [List phone number inventory](https://docs.threetone.in/api-reference/phone-numbers/list-phone-number-inventory.md): List available phone number countries, number types, and prices for the authenticated user
- [Get Agents Platform settings](https://docs.threetone.in/api-reference/agents-platform/get-agents-platform-settings.md): Retrieve Convai settings for the workspace
- [Update Agents Platform settings](https://docs.threetone.in/api-reference/agents-platform/update-agents-platform-settings.md): Update Convai settings for the workspace
- [List workspace secrets](https://docs.threetone.in/api-reference/agents-platform/list-workspace-secrets.md): Get all workspace secrets for the user
- [Create workspace secret](https://docs.threetone.in/api-reference/agents-platform/create-workspace-secret.md): Create a new secret for the workspace
- [Get workspace secret](https://docs.threetone.in/api-reference/agents-platform/get-workspace-secret.md): Get a workspace secret by ID
- [Update workspace secret](https://docs.threetone.in/api-reference/agents-platform/update-workspace-secret.md): Update an existing secret for the workspace
- [Delete workspace secret](https://docs.threetone.in/api-reference/agents-platform/delete-workspace-secret.md): Delete a workspace secret if it's not in use
- [List secret dependencies](https://docs.threetone.in/api-reference/agents-platform/list-secret-dependencies.md): Get paginated list of resources that depend on a specific secret, filtered by resource type
- [Get Agents Platform dashboard settings](https://docs.threetone.in/api-reference/agents-platform/get-agents-platform-dashboard-settings.md): Retrieve Convai dashboard settings for the workspace
- [Update Agents Platform dashboard settings](https://docs.threetone.in/api-reference/agents-platform/update-agents-platform-dashboard-settings.md): Update Convai dashboard settings for the workspace
- [Start outbound call via SIP trunk](https://docs.threetone.in/api-reference/agents-platform/start-outbound-call-via-sip-trunk.md): Handle an outbound call via SIP trunk
- [Start outbound call via Twilio](https://docs.threetone.in/api-reference/agents-platform/start-outbound-call-via-twilio.md): Handle an outbound call via Twilio
- [Register Twilio call](https://docs.threetone.in/api-reference/agents-platform/register-twilio-call.md): Register a Twilio call and return TwiML to connect the call
- [Start outbound call via Exotel](https://docs.threetone.in/api-reference/agents-platform/start-outbound-call-via-exotel.md): Handle an outbound call via Exotel Connect API
- [Start outbound call via WhatsApp](https://docs.threetone.in/api-reference/agents-platform/start-outbound-call-via-whatsapp.md): Make an outbound call via WhatsApp
- [Send outbound message via WhatsApp](https://docs.threetone.in/api-reference/agents-platform/send-outbound-message-via-whatsapp.md): Send an outbound message via WhatsApp
- [List WhatsApp accounts](https://docs.threetone.in/api-reference/agents-platform/list-whatsapp-accounts.md): List all WhatsApp accounts
- [Get WhatsApp account](https://docs.threetone.in/api-reference/agents-platform/get-whatsapp-account.md): Get a WhatsApp account
- [Update WhatsApp account](https://docs.threetone.in/api-reference/agents-platform/update-whatsapp-account.md): Update a WhatsApp account
- [Delete WhatsApp account](https://docs.threetone.in/api-reference/agents-platform/delete-whatsapp-account.md): Delete a WhatsApp account
- [List workspace batch calls](https://docs.threetone.in/api-reference/agents-platform/list-workspace-batch-calls.md): Get all batch calls for the current workspace
- [Get batch call](https://docs.threetone.in/api-reference/agents-platform/get-batch-call.md): Get detailed information about a batch call including all recipients
- [Delete batch call](https://docs.threetone.in/api-reference/agents-platform/delete-batch-call.md): Permanently delete a batch call and all recipient records. Conversations remain in history
- [Export batch call results](https://docs.threetone.in/api-reference/agents-platform/export-batch-call-results.md): Download all recipients and conversation results for a terminal batch call as CSV
- [Create batch call](https://docs.threetone.in/api-reference/agents-platform/create-batch-call.md): Submit a batch call request to schedule calls for multiple recipients
- [Cancel batch call](https://docs.threetone.in/api-reference/agents-platform/cancel-batch-call.md): Cancel a running batch call and set all recipients to cancelled status
- [Retry batch call](https://docs.threetone.in/api-reference/agents-platform/retry-batch-call.md): Retry a batch call, calling failed and no-response recipients again
- [List available AI models](https://docs.threetone.in/api-reference/agents-platform/list-available-ai-models.md): Returns the caller's provider-grouped models from the current reviewed catalog release, including exact capability and language support
- [Get available AI model](https://docs.threetone.in/api-reference/agents-platform/get-available-ai-model.md): Returns one model and its eligible variants from the current reviewed catalog release
- [List available LLMs](https://docs.threetone.in/api-reference/agents-platform/list-available-llms.md): List the LLMs available to the workspace, including capabilities and deprecation status
- [Get the platform-managed LLM backup order](https://docs.threetone.in/api-reference/agents-platform/get-the-platform-managed-llm-backup-order.md): Resolve the platform-managed backup order for a selectable primary LLM. The response contains public model identities only.
- [Calculate expected LLM usage](https://docs.threetone.in/api-reference/agents-platform/calculate-expected-llm-usage.md): Reserved compatibility operation. Product-owned LLM cost estimates are not currently available, so authorized requests return llm_estimate_unavailable (HTTP 503).
- [Calculate expected LLM usage for an agent](https://docs.threetone.in/api-reference/agents-platform/calculate-expected-llm-usage-for-an-agent.md): Reserved compatibility endpoint. Authorized requests return HTTP 503 while LLM cost estimates are unavailable.
- [Create MCP server](https://docs.threetone.in/api-reference/agents-platform/create-mcp-server.md): Create a new MCP server configuration in the workspace
- [Delete MCP server](https://docs.threetone.in/api-reference/agents-platform/delete-mcp-server.md): Delete a specific MCP server configuration from the workspace
- [List MCP servers](https://docs.threetone.in/api-reference/agents-platform/list-mcp-servers.md): Retrieve all MCP server configurations available in the workspace
- [Get MCP server](https://docs.threetone.in/api-reference/agents-platform/get-mcp-server.md): Retrieve a specific MCP server configuration from the workspace
- [List MCP server tools](https://docs.threetone.in/api-reference/agents-platform/list-mcp-server-tools.md): Retrieve all tools available for a specific MCP server configuration
- [Update MCP server configuration](https://docs.threetone.in/api-reference/agents-platform/update-mcp-server-configuration.md): Update the configuration settings for an MCP server
- [Create MCP server tool approval](https://docs.threetone.in/api-reference/agents-platform/create-mcp-server-tool-approval.md): Add approval for a specific MCP tool when using per-tool approval mode
- [Delete MCP server tool approval](https://docs.threetone.in/api-reference/agents-platform/delete-mcp-server-tool-approval.md): Remove approval for a specific MCP tool when using per-tool approval mode
- [Create MCP tool configuration override](https://docs.threetone.in/api-reference/agents-platform/create-mcp-tool-configuration-override.md): Create configuration overrides for a specific MCP tool
- [Get MCP tool configuration override](https://docs.threetone.in/api-reference/agents-platform/get-mcp-tool-configuration-override.md): Retrieve configuration overrides for a specific MCP tool
- [Update MCP tool configuration override](https://docs.threetone.in/api-reference/agents-platform/update-mcp-tool-configuration-override.md): Update configuration overrides for a specific MCP tool
- [Delete MCP tool configuration override](https://docs.threetone.in/api-reference/agents-platform/delete-mcp-tool-configuration-override.md): Remove configuration overrides for a specific MCP tool
- [Get live conversation count](https://docs.threetone.in/api-reference/agents-platform/get-live-conversation-count.md): Get the live count of the ongoing conversations
- [List environment variables](https://docs.threetone.in/api-reference/agents-platform/list-environment-variables.md): List all environment variables for the workspace with optional filtering
- [Create environment variable](https://docs.threetone.in/api-reference/agents-platform/create-environment-variable.md): Create a new environment variable for the workspace
- [Get environment variable](https://docs.threetone.in/api-reference/agents-platform/get-environment-variable.md): Get a specific environment variable by ID
- [Update environment variable](https://docs.threetone.in/api-reference/agents-platform/update-environment-variable.md): Replace an environment variable's values. Use null to remove an environment (except production)
- [Start outbound call](https://docs.threetone.in/api-reference/outbound-calls/start-outbound-call.md): Initiate a single outbound call to a phone number using an agent
- [Get workspace usage](https://docs.threetone.in/api-reference/workspace/get-workspace-usage.md): Returns credit usage broken down by product type over time. The response is a tabular structure with columns, column_types, column_units, and rows
- [List API requests](https://docs.threetone.in/api-reference/workspace/list-api-requests.md): List API requests with time, column, search, and sort filters. Provide at least one of start_time or end_time
- [Get user info](https://docs.threetone.in/api-reference/get-user-info.md): Gets information about the user
- [Get user subscription info](https://docs.threetone.in/api-reference/get-user-subscription-info.md): Gets extended information about the user's subscription
- [List workspace service accounts](https://docs.threetone.in/api-reference/workspace/list-workspace-service-accounts.md): List all service accounts in the workspace
- [Create workspace service account](https://docs.threetone.in/api-reference/workspace/create-workspace-service-account.md): Create a service account for the workspace
- [List service account API keys](https://docs.threetone.in/api-reference/workspace/list-service-account-api-keys.md): Get all API keys for a service account
- [Create service account API key](https://docs.threetone.in/api-reference/workspace/create-service-account-api-key.md): Create a new API key for a service account
- [Update service account API key](https://docs.threetone.in/api-reference/workspace/update-service-account-api-key.md): Update an existing API key for a service account
- [Delete service account API key](https://docs.threetone.in/api-reference/workspace/delete-service-account-api-key.md): Delete an existing API key for a service account
- [Set workspace third-party disabling policy](https://docs.threetone.in/api-reference/workspace/set-workspace-third-party-disabling-policy.md): Set whether holders of workspace API keys may disable their own keys. Pass null to restore each key's policy; workspace administrators only
- [Disable API key](https://docs.threetone.in/api-reference/disable-api-key.md): Allow an authenticated key to revoke only itself when policy permits
- [Get workspace audit logs](https://docs.threetone.in/api-reference/workspace/get-workspace-audit-logs.md): Returns the audit log for the workspace. Requires enterprise tier and the audit_log_read permission
- [List workspace auth connections](https://docs.threetone.in/api-reference/workspace/list-workspace-auth-connections.md): Get all auth connections for the workspace
- [Create workspace auth connection](https://docs.threetone.in/api-reference/workspace/create-workspace-auth-connection.md): Store a manual auth connection for the workspace. This does not test the remote provider
- [Update workspace auth connection](https://docs.threetone.in/api-reference/workspace/update-workspace-auth-connection.md): Update an auth connection
- [Delete workspace auth connection](https://docs.threetone.in/api-reference/workspace/delete-workspace-auth-connection.md): Delete an auth connection
- [List workspace groups](https://docs.threetone.in/api-reference/workspace/list-workspace-groups.md): Get all groups in the workspace
- [Create workspace group](https://docs.threetone.in/api-reference/workspace/create-workspace-group.md): Creates an application-managed human group in WorkOS and projects it into the workspace
- [Update workspace group](https://docs.threetone.in/api-reference/workspace/update-workspace-group.md): Updates an application-managed human group through WorkOS
- [Delete workspace group](https://docs.threetone.in/api-reference/workspace/delete-workspace-group.md): Deletes an application-managed human group through WorkOS
- [Search user groups](https://docs.threetone.in/api-reference/workspace/search-user-groups.md): Searches for user groups in the workspace. Multiple or no groups may be returned
- [Add member to user group](https://docs.threetone.in/api-reference/workspace/add-member-to-user-group.md): Adds a member of your workspace to the specified group. Requires `group_members_manage` permission
- [Remove member from workspace group](https://docs.threetone.in/api-reference/workspace/remove-member-from-workspace-group.md): Removes a member from the specified group. Requires `group_members_manage` permission
- [Delete workspace invitation](https://docs.threetone.in/api-reference/workspace/delete-workspace-invitation.md): Invalidate a pending workspace invitation. Requires the workspace members invite permission
- [Invite user](https://docs.threetone.in/api-reference/workspace/invite-user.md): Email an invitation to join the workspace. Requires the workspace members invite permission and an available seat
- [Invite multiple users](https://docs.threetone.in/api-reference/workspace/invite-multiple-users.md): Email invitations to multiple addresses on a verified domain. Requires the workspace members invite permission and an available seat for each accepted invitation
- [Resend workspace invitation](https://docs.threetone.in/api-reference/workspace/resend-workspace-invitation.md): Requests delivery for an existing pending WorkOS invitation. WorkOS owns delivery before category cutover; the Threetone mail pipeline owns it after cutover
- [Update member](https://docs.threetone.in/api-reference/workspace/update-member.md): Update the specified fields of a workspace member. Workspace administrators only
- [Get resource](https://docs.threetone.in/api-reference/workspace/get-resource.md): Gets the metadata of a resource by ID
- [Share workspace resource](https://docs.threetone.in/api-reference/workspace/share-workspace-resource.md): Grant a user or group a role on a workspace resource. You must have administrator access to the resource
- [Unshare workspace resource](https://docs.threetone.in/api-reference/workspace/unshare-workspace-resource.md): Remove a user or group's role from a workspace resource. You must have administrator access to the resource
- [List workspace webhooks](https://docs.threetone.in/api-reference/workspace/list-workspace-webhooks.md): List all webhooks for a workspace
- [Create workspace webhook](https://docs.threetone.in/api-reference/workspace/create-workspace-webhook.md): Create a new webhook for the workspace with the specified authentication type
- [Update workspace webhook](https://docs.threetone.in/api-reference/workspace/update-workspace-webhook.md): Update the specified workspace webhook
- [Delete workspace webhook](https://docs.threetone.in/api-reference/workspace/delete-workspace-webhook.md): Delete the specified workspace webhook
- [List my voices](https://docs.threetone.in/api-reference/voices/list-my-voices.md): List voices saved by the current workspace, including unavailable bookmarks.
- [Get a saved voice](https://docs.threetone.in/api-reference/voices/get-a-saved-voice.md): Get one voice saved in the current workspace library, including its current availability.
- [Resolve a local wall time](https://docs.threetone.in/api-reference/time-zones/resolve-a-local-wall-time.md): Rejects daylight-saving gaps. For a repeated wall time, resolve once with `earlier` and once with `later` to inspect both possible instants

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.