# Agni

## Docs

- [Agni - by Ravan.ai](https://docs.ravan.ai/index.md): The world's most natural voice AI. Real emotion. Real turn-taking. Real conversation. Not a chatbot. Not a script. Just talk.
- [Authentication](https://docs.ravan.ai/guides/authentication.md): Create your organization, verify your identity, and get your API key to start building with Agni.
- [API keys](https://docs.ravan.ai/guides/api-keys.md): Understand what API keys are, how Agni uses them, and how developers should handle them securely.
- [Organizations and roles](https://docs.ravan.ai/guides/organizations-and-roles.md): Understand how Agni organizations, admins, and users work together.
- [Dashboard Overview](https://docs.ravan.ai/guides/dashboard.md): Your central command center for monitoring agent performance, tracking usage, and navigating your Agni workspace.
- [Build your first phone agent in 5 minutes](https://docs.ravan.ai/guides/create-first-agent.md): Step-by-step guide to create, test, and deploy your first AI phone agent.
- [Agents](https://docs.ravan.ai/guides/agents.md): Create, configure, and test real-time voice AI agents with custom voices, tools, and call handling behavior.
- [Knowledge Base](https://docs.ravan.ai/guides/knowledge-base.md): Give your voice agents domain expertise with RAG-powered knowledge bases. Upload documents, configure retrieval, and improve answer accuracy.
- [Platform Analytics](https://docs.ravan.ai/guides/analytics.md): Monitor call volume, track success rates, analyze sentiment, and measure agent performance across your entire voice infrastructure.
- [Webhooks](https://docs.ravan.ai/guides/webhooks.md): Receive real-time notifications for call events, transcripts, and post-call analysis using Agni webhooks.
- [Tools & Functions](https://docs.ravan.ai/guides/tools.md): Equip your AI agents with real-world capabilities—end calls, transfer to humans, navigate IVRs, and call external APIs during live conversations.
- [Prompt Engineering](https://docs.ravan.ai/guides/prompt-engineering.md): Write effective system prompts for your Agni voice agents. Templates, best practices, and industry-specific examples.
- [Inbound Calls](https://docs.ravan.ai/guides/inbound-calls.md): Connect phone numbers to AI agents with dispatch rules so your agents automatically answer incoming calls.
- [Outbound](https://docs.ravan.ai/guides/campaigns.md): Run outbound calling at scale from the Campaigns section. Create outbound workflows, manage contact lists, monitor performance, and optimize results.
- [All Call History](https://docs.ravan.ai/guides/calls.md): Monitor, filter, and review every conversation handled by your Agni agents—including transcripts, recordings, summaries, credit usage, and sentiment analysis.
- [Appointments](https://docs.ravan.ai/guides/appointments.md): View and manage calendar bookings generated by your voice AI agents. Currently visualizing GoHighLevel integrations.
- [Contacts](https://docs.ravan.ai/guides/contacts.md): Manage your global contact list and view detailed interaction histories for outbound campaigns.
- [Integrations](https://docs.ravan.ai/guides/Integration.md): Connect Agni with your favorite external tools and workflows like GoHighLevel and Cal.com.
- [Phone Numbers](https://docs.ravan.ai/guides/phone-numbers.md): Provision, manage, and configure the telephony infrastructure for your AI agents—including Twilio, managed accounts, and custom SIP providers.
- [Billing](https://docs.ravan.ai/guides/billing.md): Manage your subscription plan, purchase credits, monitor usage costs, and access billing history.
- [Workspace Settings](https://docs.ravan.ai/guides/settings.md): Configure your organization, manage team access, secure your account, generate API keys, and connect third-party integrations.
- [Enterprise plan](https://docs.ravan.ai/guides/enterprise-plan.md): Private onboarding and appointment booking for enterprise customers.
- [Support](https://docs.ravan.ai/guides/support.md): Contact Agni support, share the right troubleshooting details, and report urgent production outages.
- [Error codes](https://docs.ravan.ai/guides/error-codes.md): Understand call failure errors, SIP status codes, Twirp wrappers, and the recommended next step for each failure.
- [Troubleshooting](https://docs.ravan.ai/guides/troubleshooting.md): Diagnose and fix common issues with Agni voice agents. Call failures, voice quality, integration problems, and performance tips.
- [Trust Center](https://docs.ravan.ai/guides/trust-center.md): Agni is built on enterprise-grade security. SOC 2 Type II certified, GDPR ready, HIPAA compliant, and hosted on AWS infrastructure.
- [API overview](https://docs.ravan.ai/api-reference/introduction.md): Authentication and endpoint groups for Agni APIs.
- [Get Agent](https://docs.ravan.ai/api-reference/agents/get.md): Get Agent.
- [List Agents](https://docs.ravan.ai/api-reference/agents/list.md): List Agents.
- [List LLM Models With Voices](https://docs.ravan.ai/api-reference/models/list-with-voices.md): List available LLM models and their supported voices.
- [List Voices for LLM Model](https://docs.ravan.ai/api-reference/models/list-voices.md): List available voices for a specific LLM model.
- [Create Agent](https://docs.ravan.ai/api-reference/agents/create.md): Create Agent.
- [Update Agent](https://docs.ravan.ai/api-reference/agents/update.md): Update Agent.
- [Update Agent Status](https://docs.ravan.ai/api-reference/agents/update-status.md): Update Agent Status.
- [Delete Agent](https://docs.ravan.ai/api-reference/agents/delete.md): Delete Agent.
- [Get organization profile](https://docs.ravan.ai/api-reference/organizations/profile.md): Get the organization profile, including the effective plan, limits, and available credits.
- [Get Agent Tool](https://docs.ravan.ai/api-reference/tools/get.md): Fetch a single tool by ID for the authenticated organization.
- [List Agent Tools](https://docs.ravan.ai/api-reference/tools/list.md): List agent tools for the authenticated organization, optionally filtered by agent.
- [Create Agent Tool](https://docs.ravan.ai/api-reference/tools/create.md): Create Agent Tool.
- [Update Agent Tool](https://docs.ravan.ai/api-reference/tools/update.md): Update Agent Tool.
- [Delete Agent Tool](https://docs.ravan.ai/api-reference/tools/delete.md): Delete Agent Tool.
- [List Available Numbers](https://docs.ravan.ai/api-reference/telephony/list-available-numbers.md): List Available Numbers.
- [List Purchased Numbers](https://docs.ravan.ai/api-reference/telephony/list-purchased-numbers.md): List Purchased Numbers.
- [List Imported Numbers](https://docs.ravan.ai/api-reference/telephony/list-imported-numbers.md): List Imported Numbers.
- [Get Imported Number](https://docs.ravan.ai/api-reference/telephony/get-imported-number.md): Get Imported Number.
- [List Twilio Owned Numbers](https://docs.ravan.ai/api-reference/telephony/list-twilio-numbers.md): List Twilio Owned Numbers.
- [Get Selected Telephony](https://docs.ravan.ai/api-reference/telephony/get-selected-telephony.md): Get Selected Telephony.
- [Buy Phone Number](https://docs.ravan.ai/api-reference/telephony/buy-number.md): Buy Phone Number.
- [Import Phone Number](https://docs.ravan.ai/api-reference/telephony/import-number.md): Import Phone Number.
- [Add Twilio Number](https://docs.ravan.ai/api-reference/telephony/add-twilio-number.md): Add Twilio Number.
- [Create Telephony Type](https://docs.ravan.ai/api-reference/telephony/create-telephony.md): Create Telephony Type.
- [Update Imported Number](https://docs.ravan.ai/api-reference/telephony/update-imported-number.md): Update Imported Number.
- [Release Phone Number](https://docs.ravan.ai/api-reference/telephony/release-number.md): Release Phone Number.
- [Delete Imported Number](https://docs.ravan.ai/api-reference/telephony/delete-imported-number.md): Delete Imported Number.
- [List Campaigns](https://docs.ravan.ai/api-reference/campaigns/list.md): List Campaigns.
- [Get Campaign](https://docs.ravan.ai/api-reference/campaigns/get.md): Get Campaign.
- [List Campaign Contacts](https://docs.ravan.ai/api-reference/campaigns/list-contacts.md): List Campaign Contacts.
- [Create Campaign](https://docs.ravan.ai/api-reference/campaigns/create.md): Create Campaign.
- [Start Campaign](https://docs.ravan.ai/api-reference/campaigns/start.md): Start Campaign.
- [Pause Campaign](https://docs.ravan.ai/api-reference/campaigns/pause.md): Pause Campaign.
- [Resume Campaign](https://docs.ravan.ai/api-reference/campaigns/resume.md): Resume Campaign.
- [Add Contacts to Campaign](https://docs.ravan.ai/api-reference/campaigns/add-contacts.md): Add Contacts to Campaign.
- [Update Campaign](https://docs.ravan.ai/api-reference/campaigns/update.md): Update Campaign.
- [Delete Campaign](https://docs.ravan.ai/api-reference/campaigns/delete.md): Delete Campaign.
- [Remove Contact from Campaign](https://docs.ravan.ai/api-reference/campaigns/remove-contact.md): Remove Contact from Campaign.
- [Get Contact](https://docs.ravan.ai/api-reference/contacts/get.md): Get Contact.
- [List Contacts](https://docs.ravan.ai/api-reference/contacts/list.md): List Contacts.
- [Get Contact Detail](https://docs.ravan.ai/api-reference/contacts/detail.md): Get Contact Detail.
- [Get Contact Calls](https://docs.ravan.ai/api-reference/contacts/calls.md): Get Contact Calls.
- [Get Contact Call Stats](https://docs.ravan.ai/api-reference/contacts/call-stats.md): Get Contact Call Stats.
- [Get Contact Activities](https://docs.ravan.ai/api-reference/contacts/activities.md): Get Contact Activities.
- [Get Contact Campaigns](https://docs.ravan.ai/api-reference/contacts/campaigns.md): Get Contact Campaigns.
- [List Contact Notes](https://docs.ravan.ai/api-reference/contacts/list-notes.md): List Contact Notes.
- [Create Contact](https://docs.ravan.ai/api-reference/contacts/create.md): Create Contact.
- [Bulk Delete Contacts](https://docs.ravan.ai/api-reference/contacts/bulk-delete.md): Bulk Delete Contacts.
- [Create Contact Note](https://docs.ravan.ai/api-reference/contacts/create-note.md): Create Contact Note.
- [Update Contact](https://docs.ravan.ai/api-reference/contacts/update.md): Update Contact.
- [Delete Contact](https://docs.ravan.ai/api-reference/contacts/delete.md): Delete Contact.
- [List Call Sessions](https://docs.ravan.ai/api-reference/calling/list-sessions.md): List Call Sessions.
- [Get Call Session Detail](https://docs.ravan.ai/api-reference/calling/get-session-detail.md): Get Call Session Detail with Transcripts.
- [Phone Call History](https://docs.ravan.ai/api-reference/calling/phone-history.md): Returns all calls where a phone number appears as caller or callee, with cost and credit details and optional transcripts.
- [Create Call](https://docs.ravan.ai/api-reference/calling/create-call.md): Create Call.
- [Manage GHL Appointment](https://docs.ravan.ai/api-reference/appointments/manage-ghl.md): Manage an appointment request for the AI agent; no X-Api-Key is required, and `org_id` is provided in the request body.
- [Manage Cal.com Appointment](https://docs.ravan.ai/api-reference/appointments/manage-calcom.md): Manage an appointment request for the AI agent; no X-Api-Key is required, and `org_id` is provided in the request body.
- [GHL Setup Status](https://docs.ravan.ai/api-reference/ghl/setup-status.md): GHL Setup Status.
- [List GHL Calendars](https://docs.ravan.ai/api-reference/ghl/list-calendars.md): List GHL Calendars.
- [Get GHL Agent by Calendar](https://docs.ravan.ai/api-reference/ghl/get-agent-by-calendar.md): Get GHL Agent by Calendar.
- [List GHL Appointments](https://docs.ravan.ai/api-reference/ghl/list-appointments.md): List GHL Appointments.
- [Get GHL Appointment](https://docs.ravan.ai/api-reference/ghl/get-appointment.md): Get GHL Appointment.
- [GHL OAuth Authorize](https://docs.ravan.ai/api-reference/ghl/oauth-authorize.md): GHL OAuth Authorize.
- [GHL OAuth Callback](https://docs.ravan.ai/api-reference/ghl/oauth-callback.md): GHL OAuth Callback.
- [Save Call Data](https://docs.ravan.ai/api-reference/ghl/save-call-data.md): Save Call Data.
- [Get or Create Contact](https://docs.ravan.ai/api-reference/ghl/get-or-create-contact.md): Get or Create Contact.
- [Disconnect GHL](https://docs.ravan.ai/api-reference/ghl/disconnect.md): Disconnect GHL.
- [Cal.com OAuth Connect](https://docs.ravan.ai/api-reference/calcom/oauth-connect.md): Cal.com OAuth Connect.
- [Cal.com OAuth Callback](https://docs.ravan.ai/api-reference/calcom/oauth-callback.md): Cal.com OAuth Callback.
- [Cal.com Connection Status](https://docs.ravan.ai/api-reference/calcom/status.md): Returns the connection status of all org-level Cal.com accounts.
- [List Cal.com Event Types](https://docs.ravan.ai/api-reference/calcom/list-event-types.md): Lists event types fetched live from Cal.com across all connected org-level accounts, or one account if `account_id` is provided.
- [Lookup Cal.com Event Type](https://docs.ravan.ai/api-reference/calcom/lookup-event-type.md): Looks up a single event type by its Cal.com numeric ID or slug across all connected accounts for the organization.
- [List Cal.com Appointments](https://docs.ravan.ai/api-reference/calcom/list-appointments.md): Lists bookings fetched live from the organization's primary Cal.com account.
- [Get Appointment](https://docs.ravan.ai/api-reference/calcom/get-appointment.md): Fetches a single booking by its Cal.com booking UID from the organization's primary Cal.com account.
- [Get Agent Cal.com Account](https://docs.ravan.ai/api-reference/calcom/get-agent-account.md): Returns the effective Cal.com account for an agent with priority: agent private key, then org-linked account, then none.
- [Get Agent Cal.com Status](https://docs.ravan.ai/api-reference/calcom/agent-status.md): Returns the connection status of the agent's private Cal.com account or accounts.
- [Get Agent Cal.com Info](https://docs.ravan.ai/api-reference/calcom/agent-info.md): Returns the effective Cal.com connection info for an agent with priority: private key, then org-linked account, then none.
- [Disconnect Cal.com](https://docs.ravan.ai/api-reference/calcom/disconnect.md): Disconnects an org-level Cal.com account by soft deleting it, setting the status to inactive and clearing the API key. Disconnects all org-level accounts unless `provider_id` is provided.
- [Connect Agent Cal.com](https://docs.ravan.ai/api-reference/calcom/connect-agent.md): Connects a private white-label Cal.com API key for a single agent. The request is blocked if the agent already has an org-level Cal.com account linked.
- [Assign Cal.com Account to Agent](https://docs.ravan.ai/api-reference/calcom/assign-agent-account.md): Links or unlinks an org-level Cal.com account to an agent. The request is rejected if the agent already has a private agent-level Cal.com API key.
- [Disconnect Agent Cal.com](https://docs.ravan.ai/api-reference/calcom/disconnect-agent.md): Removes the agent's private Cal.com key and clears any `calcom_account_id` on the agent row.
- [Get Knowledge Base](https://docs.ravan.ai/api-reference/rag/get-knowledge-base.md): Get Knowledge Base.
- [List Knowledge Bases](https://docs.ravan.ai/api-reference/rag/list-knowledge-bases.md): List Knowledge Bases.
- [Get Document](https://docs.ravan.ai/api-reference/rag/get-document.md): Get Document.
- [List Documents](https://docs.ravan.ai/api-reference/rag/list-documents.md): List Documents.
- [List Exclusions](https://docs.ravan.ai/api-reference/rag/list-exclusions.md): List Exclusions.
- [Create Knowledge Base](https://docs.ravan.ai/api-reference/rag/create-knowledge-base.md): Create Knowledge Base.
- [Add Sources](https://docs.ravan.ai/api-reference/rag/add-sources.md): Add Sources to Knowledge Base.
- [Upsert Document](https://docs.ravan.ai/api-reference/rag/upsert-document.md): Upsert Document.
- [Query Knowledge Base](https://docs.ravan.ai/api-reference/rag/query.md): Query Knowledge Base.
- [Discover URLs](https://docs.ravan.ai/api-reference/rag/discover-urls.md): Discover URLs.
- [Refresh Knowledge Base](https://docs.ravan.ai/api-reference/rag/refresh.md): Refresh Knowledge Base.
- [Manage Exclusions](https://docs.ravan.ai/api-reference/rag/manage-exclusions.md): Manage Exclusions.
- [Delete Knowledge Base](https://docs.ravan.ai/api-reference/rag/delete-knowledge-base.md): Delete Knowledge Base.
- [Delete Source](https://docs.ravan.ai/api-reference/rag/delete-source.md): Delete Source from Knowledge Base.
- [After-Call Webhook](https://docs.ravan.ai/api-reference/webhooks/call-completed.md): Receive detailed call data automatically when a call ends — including transcripts, recordings, sentiment analysis, and post-call extraction.
- [Health Check](https://docs.ravan.ai/api-reference/health/health.md): Health Check.
- [Readiness Check](https://docs.ravan.ai/api-reference/health/ready.md): Readiness Check.

## OpenAPI Specs

- [openapi](https://docs.ravan.ai/openapi.json)

## Optional

- [Demo](https://agni.ravan.ai)
- [Website](https://app.ravan.ai)