# Rydhm Docs ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rydhm.ai/_mcp/server ## Docs - [Welcome to Rydhm](https://docs.rydhm.ai/get-started/welcome.md): Build voice and chat experts that know your business, then put them where your customers are. - [Quickstart](https://docs.rydhm.ai/get-started/quickstart.md): Build, test and share your first expert in about 10 minutes. - [Concepts](https://docs.rydhm.ai/get-started/concepts.md): The handful of ideas the rest of the docs rely on. - [Create an expert](https://docs.rydhm.ai/experts/create.md): The four ways to start an expert, and a tour of its settings. - [Persona, first message and variables](https://docs.rydhm.ai/experts/persona.md): Tell the expert who it is, what it says first, and which details to fill in for each conversation. - [Voice engines](https://docs.rydhm.ai/experts/voice-engines.md): Pipeline, Gemini Live or GPT-Live — what each is good at, how fast it answers, and what it costs. - [Voices](https://docs.rydhm.ai/experts/voices.md): Browse the voice library, listen in any language, and give a voice to an expert. - [Languages](https://docs.rydhm.ai/experts/languages.md): Tell an expert which languages its callers speak, so it hears them correctly and answers in kind. - [Guardrails and call experience](https://docs.rydhm.ai/experts/guardrails.md): Keep an expert on topic, set rules it never breaks, and decide how a call feels. - [Tools](https://docs.rydhm.ai/experts/tools.md): Let an expert look things up and take actions mid-conversation, with confirmation where it matters. - [Specialists](https://docs.rydhm.ai/experts/specialists.md): Build a team of experts that hand a live call to each other when a caller asks for a colleague. - [Versions and testing](https://docs.rydhm.ai/experts/versions.md): Try unsaved edits safely, recover lost drafts, and restore any earlier version of an expert. - [Knowledge overview](https://docs.rydhm.ai/knowledge/overview.md): What an expert knows, where that knowledge lives, and how the expert uses it to answer. - [Knowledge library](https://docs.rydhm.ai/knowledge/library.md): Every folder, every expert's own knowledge and every document, in one place. - [Website import](https://docs.rydhm.ai/knowledge/website-import.md): Read your website's pages into an expert's knowledge, and refresh them when the site changes. - [Questions and answers](https://docs.rydhm.ai/knowledge/faqs.md): Give an expert your exact answers to the questions you hear most. - [Search and sources](https://docs.rydhm.ai/knowledge/search.md): How an expert finds the right passage, how to check it yourself, and what people see under a reply. - [Website widget](https://docs.rydhm.ai/channels/web-widget.md): Put a chat and voice bubble for your expert on your own website with two lines of HTML. - [Public links](https://docs.rydhm.ai/channels/public-links.md): Share an expert with a link anyone can open to talk or chat, no account needed. - [Chat](https://docs.rydhm.ai/channels/chat.md): Text conversations with your experts, in the app and on your public page or widget, with sources and safety screening. - [Meetings](https://docs.rydhm.ai/channels/meetings.md): Send an expert into Google Meet, Zoom or Microsoft Teams to talk, take the transcript and write the summary. - [Phone](https://docs.rydhm.ai/channels/phone.md): Give an expert a US phone number to answer calls 24/7, call people, transfer to your team and leave voicemails. - [Bring your own Twilio](https://docs.rydhm.ai/channels/byo-twilio.md): Connect your Twilio account so your experts answer and call from numbers you already own. - [Campaigns](https://docs.rydhm.ai/channels/campaigns.md): Have an expert call a list of people, at hours that are legal where each person is. - [Conversations](https://docs.rydhm.ai/quality/conversations.md): Every meeting, chat and call with your experts in one list, with transcripts, analysis and undoable delete. - [Analytics](https://docs.rydhm.ai/quality/analytics.md): See how your experts are doing, with conversations, outcomes, speed, visitor feedback and cost. - [Test suites](https://docs.rydhm.ai/quality/test-suites.md): Prove an expert behaves before customers find out, with simulated conversations graded line by line. - [Members and roles](https://docs.rydhm.ai/workspace/members.md): Invite your team, and choose who can change experts, settings and money. - [Billing and credits](https://docs.rydhm.ai/workspace/billing.md): Plans, credits, what each channel costs, top-ups and plan limits. - [Provider keys](https://docs.rydhm.ai/workspace/provider-keys.md): Run your experts' calls on your own OpenAI, Anthropic, Google, Deepgram or Cartesia accounts. - [Alerts](https://docs.rydhm.ai/workspace/alerts.md): Get told when calls fail, phones go unanswered or webhooks break, in the app, by email, in Slack or in PagerDuty. - [Export your data](https://docs.rydhm.ai/workspace/export.md): Download everything in your workspace as one zip file. - [Security](https://docs.rydhm.ai/workspace/security.md): Roles, API key scopes, the audit log, Rydhm staff access, data retention and deletion, and how secrets are kept. - [Developer overview](https://docs.rydhm.ai/developers/overview.md): Build on Rydhm from your own code. Base URLs, versioning, and your first request. - [Authentication](https://docs.rydhm.ai/developers/authentication.md): Create API keys, send them as a Bearer token, and rotate or revoke them safely. - [Scopes](https://docs.rydhm.ai/developers/scopes.md): What each API key permission allows, and the routes it opens. - [Errors](https://docs.rydhm.ai/developers/errors.md): The error shape, the status codes the API uses, and how rate limits work. - [Pagination](https://docs.rydhm.ai/developers/pagination.md): How paged lists work, and how much the other lists return. - [Webhooks](https://docs.rydhm.ai/developers/webhooks.md): Get an HTTPS request when something happens in your workspace, signed so you can trust it. - [MCP](https://docs.rydhm.ai/developers/mcp.md): Use any expert as a Model Context Protocol server from Claude, Cursor and other AI tools. - [Embed](https://docs.rydhm.ai/developers/embed.md): Put an expert on your website with one tag, pass it values about the visitor, and choose who may embed it. - [Agent to agent (A2A)](https://docs.rydhm.ai/developers/a2a.md): Let other AI agents discover a published expert, and talk to public experts with no key. - [TypeScript SDK](https://docs.rydhm.ai/developers/sdk-typescript.md): Call the Rydhm API from Node.js and TypeScript with typed requests, responses and errors. - [Python SDK](https://docs.rydhm.ai/developers/sdk-python.md): Call the Rydhm API from Python, with typed models, streaming and an async client. - [Changelog](https://docs.rydhm.ai/changelog/llms.txt) ## API Docs - API reference > Experts [List experts](https://docs.rydhm.ai/api-reference/experts/list.md) - API reference > Experts [Create an expert](https://docs.rydhm.ai/api-reference/experts/create.md) - API reference > Experts [Get an expert](https://docs.rydhm.ai/api-reference/experts/get.md) - API reference > Experts [Edit an expert](https://docs.rydhm.ai/api-reference/experts/update.md) - API reference > Experts [Save MCP servers and hand-off specialists](https://docs.rydhm.ai/api-reference/experts/update-connections.md) - API reference > Experts [Publish or unpublish](https://docs.rydhm.ai/api-reference/experts/publish.md) - API reference > Experts > Versions [Version history](https://docs.rydhm.ai/api-reference/experts/versions/list.md) - API reference > Experts > Versions [One version, with its snapshot](https://docs.rydhm.ai/api-reference/experts/versions/get.md) - API reference > Experts > Versions [Restore a version](https://docs.rydhm.ai/api-reference/experts/versions/restore.md) - API reference > Knowledge [List documents](https://docs.rydhm.ai/api-reference/knowledge/list.md) - API reference > Knowledge [Add a text document](https://docs.rydhm.ai/api-reference/knowledge/add.md) - API reference > Knowledge [Upload a file](https://docs.rydhm.ai/api-reference/knowledge/add-file.md) - API reference > Knowledge [Search the knowledge](https://docs.rydhm.ai/api-reference/knowledge/search.md) - API reference > Knowledge [Add a question-and-answer document](https://docs.rydhm.ai/api-reference/knowledge/add-faq.md) - API reference > Knowledge [An expert's website imports](https://docs.rydhm.ai/api-reference/knowledge/list-imports.md) - API reference > Knowledge [Import a website for an expert](https://docs.rydhm.ai/api-reference/knowledge/import-website.md) - API reference > Knowledge [The collections an expert reads from](https://docs.rydhm.ai/api-reference/knowledge/list-collections.md) - API reference > Knowledge [Set which collections an expert reads from](https://docs.rydhm.ai/api-reference/knowledge/set-collections.md) - API reference > Knowledge [Knowledge storage used against the plan](https://docs.rydhm.ai/api-reference/knowledge/usage.md) - API reference > Knowledge > Documents [Get a document](https://docs.rydhm.ai/api-reference/knowledge/documents/get.md) - API reference > Knowledge > Documents [Remove a document](https://docs.rydhm.ai/api-reference/knowledge/documents/delete.md) - API reference > Knowledge > Documents [Replace a question-and-answer document](https://docs.rydhm.ai/api-reference/knowledge/documents/replace-faq.md) - API reference > Knowledge > Documents [Index a failed document again](https://docs.rydhm.ai/api-reference/knowledge/documents/retry.md) - API reference > Knowledge > Collections [List collections](https://docs.rydhm.ai/api-reference/knowledge/collections/list.md) - API reference > Knowledge > Collections [Create a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/create.md) - API reference > Knowledge > Collections [Get a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/get.md) - API reference > Knowledge > Collections [Delete a collection and its documents](https://docs.rydhm.ai/api-reference/knowledge/collections/delete.md) - API reference > Knowledge > Collections [Rename or describe a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/update.md) - API reference > Knowledge > Collections [A collection's documents](https://docs.rydhm.ai/api-reference/knowledge/collections/list-documents.md) - API reference > Knowledge > Collections [Add a text document to a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/add.md) - API reference > Knowledge > Collections [Upload a file to a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/add-file.md) - API reference > Knowledge > Collections [Add a question-and-answer document to a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/add-faq.md) - API reference > Knowledge > Collections [A collection's website imports](https://docs.rydhm.ai/api-reference/knowledge/collections/list-imports.md) - API reference > Knowledge > Collections [Import a website into a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/import-website.md) - API reference > Knowledge > Collections [Search a collection](https://docs.rydhm.ai/api-reference/knowledge/collections/search.md) - API reference > Knowledge > Imports [Preview which pages a website import would take](https://docs.rydhm.ai/api-reference/knowledge/imports/preview.md) - API reference > Knowledge > Imports [Get a website import](https://docs.rydhm.ai/api-reference/knowledge/imports/get.md) - API reference > Knowledge > Imports [Remove a website import and its pages](https://docs.rydhm.ai/api-reference/knowledge/imports/delete.md) - API reference > Knowledge > Imports [Fetch a website import again](https://docs.rydhm.ai/api-reference/knowledge/imports/refresh.md) - API reference > Knowledge > Imports [Stop a running website import](https://docs.rydhm.ai/api-reference/knowledge/imports/cancel.md) - API reference > Knowledge > Library [The knowledge library](https://docs.rydhm.ai/api-reference/knowledge/library/list.md) - API reference > Knowledge > Library [Who added knowledge](https://docs.rydhm.ai/api-reference/knowledge/library/creators.md) - API reference > Knowledge > Library [A document's detail](https://docs.rydhm.ai/api-reference/knowledge/library/get.md) - API reference > Knowledge > Library [Rename a document](https://docs.rydhm.ai/api-reference/knowledge/library/rename.md) - API reference > Knowledge > Library [Move a document to a folder or an expert](https://docs.rydhm.ai/api-reference/knowledge/library/move.md) - API reference > Knowledge > Library [Delete up to 100 documents](https://docs.rydhm.ai/api-reference/knowledge/library/bulk-delete.md) - API reference > Knowledge > Library [Refresh every website import](https://docs.rydhm.ai/api-reference/knowledge/library/sync.md) - API reference > Conversations and chat [List conversations](https://docs.rydhm.ai/api-reference/conversations/list.md) - API reference > Conversations and chat [Delete a conversation](https://docs.rydhm.ai/api-reference/conversations/delete.md) - API reference > Conversations and chat [Undo a delete](https://docs.rydhm.ai/api-reference/conversations/restore.md) - API reference > Conversations and chat [Read messages](https://docs.rydhm.ai/api-reference/conversations/get.md) - API reference > Conversations and chat [Start a chat](https://docs.rydhm.ai/api-reference/conversations/start.md) - API reference > Conversations and chat [Send a message](https://docs.rydhm.ai/api-reference/conversations/send.md) - API reference > Conversations and chat [Stream the reply](https://docs.rydhm.ai/api-reference/conversations/stream.md) - API reference > Voice [Mint a voice-session token](https://docs.rydhm.ai/api-reference/voice/create-session.md) - API reference > Meetings [List meetings](https://docs.rydhm.ai/api-reference/meetings/list.md) - API reference > Meetings [Send an expert to a meeting](https://docs.rydhm.ai/api-reference/meetings/join.md) - API reference > Meetings [Are meeting bots set up?](https://docs.rydhm.ai/api-reference/meetings/status.md) - API reference > Meetings [A meeting with its transcript and summary](https://docs.rydhm.ai/api-reference/meetings/get.md) - API reference > Meetings [Delete a meeting](https://docs.rydhm.ai/api-reference/meetings/delete.md) - API reference > Meetings [The summary](https://docs.rydhm.ai/api-reference/meetings/get-summary.md) - API reference > Meetings [Regenerate the summary](https://docs.rydhm.ai/api-reference/meetings/regenerate-summary.md) - API reference > Meetings [The meeting brief as a PDF](https://docs.rydhm.ai/api-reference/meetings/download-brief.md) - API reference > Meetings [Cancel a scheduled meeting](https://docs.rydhm.ai/api-reference/meetings/cancel.md) - API reference > Meetings [Take the expert out of a live meeting](https://docs.rydhm.ai/api-reference/meetings/leave.md) - API reference > Tools [List tools](https://docs.rydhm.ai/api-reference/tools/list.md) - API reference > Tools [Create a tool](https://docs.rydhm.ai/api-reference/tools/create.md) - API reference > Tools [Get a tool](https://docs.rydhm.ai/api-reference/tools/get.md) - API reference > Tools [Delete a tool](https://docs.rydhm.ai/api-reference/tools/delete.md) - API reference > Tools [Edit a tool](https://docs.rydhm.ai/api-reference/tools/update.md) - API reference > Tools [Recent calls of a tool](https://docs.rydhm.ai/api-reference/tools/list-calls.md) - API reference > Tools [Give a tool to an expert (or take it away)](https://docs.rydhm.ai/api-reference/tools/assign.md) - API reference > Tools [Test a tool](https://docs.rydhm.ai/api-reference/tools/test.md) - API reference > Tools [Turn a curl command into a tool draft](https://docs.rydhm.ai/api-reference/tools/parse-curl.md) - API reference > Tools [Draft a tool from a description](https://docs.rydhm.ai/api-reference/tools/draft.md) - API reference > Tools [Test an unsaved tool draft](https://docs.rydhm.ai/api-reference/tools/test-draft.md) - API reference > Analytics [Usage by day](https://docs.rydhm.ai/api-reference/analytics/usage.md) - API reference > Analytics [Outcomes overview](https://docs.rydhm.ai/api-reference/analytics/overview.md) - API reference > Analytics [Latency per expert](https://docs.rydhm.ai/api-reference/analytics/latency.md) - API reference > Analytics [What is live right now](https://docs.rydhm.ai/api-reference/analytics/live.md) - API reference > Analytics [Analyses as CSV](https://docs.rydhm.ai/api-reference/analytics/export-csv.md) - API reference > MCP (AI tools) [The expert as an MCP server (Streamable HTTP)](https://docs.rydhm.ai/api-reference/mcp/send.md) - API reference > Public (no key) [A published expert’s profile](https://docs.rydhm.ai/api-reference/public/get.md) - API reference > Public (no key) [Start a voice session with a published expert](https://docs.rydhm.ai/api-reference/public/start-voice-session.md) - API reference > Public (no key) [Start a text chat with a published expert](https://docs.rydhm.ai/api-reference/public/start-chat.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.rydhm.ai/openapi.json) - [OpenAPI YAML](https://docs.rydhm.ai/openapi.yaml)