# Flireo AI ## Docs - Root > Get started [Quickstart](https://doc.flireo.com/quickstart.md): - Root > Get started [Introduction](https://doc.flireo.com/quickstart/introduction.md): - Root > Get started [Authentication](https://doc.flireo.com/quickstart/authentication.md): - Root > Core concepts [Agents](https://doc.flireo.com/agents-1861370m0.md): - Root > Core concepts [Phone numbers](https://doc.flireo.com/phone-numbers-1861371m0.md): - Root > Core concepts [Calls](https://doc.flireo.com/calls-1861372m0.md): - Root > Core concepts [Webhooks](https://doc.flireo.com/webhooks-1861373m0.md): - Root > Api's [Organization](https://doc.flireo.com/organization-1861374m0.md): - Root > Api's [Agents](https://doc.flireo.com/agents-1861375m0.md): - Root > Api's [Phone numbers](https://doc.flireo.com/phone-numbers-1861376m0.md): - Root > Api's [Sip trunks](https://doc.flireo.com/sip-trunks-1861377m0.md): - Root > Api's [Calls](https://doc.flireo.com/calls-1861378m0.md): - Root > Api's [Call control](https://doc.flireo.com/call-control-1861381m0.md): - Root > Api's [Usage](https://doc.flireo.com/usage-1861382m0.md): - Root > Api's [Voices](https://doc.flireo.com/voices-1861383m0.md): - Root > Api's [BYOK](https://doc.flireo.com/byok-1861384m0.md): - Root > Api's [Domains](https://doc.flireo.com/domains-1861385m0.md): - Root > Api's [Analysis templates](https://doc.flireo.com/analysis-templates-1892892m0.md): - Root > Api's [Tool templates](https://doc.flireo.com/tool-templates-1892895m0.md): - Root > Webhooks [Overview](https://doc.flireo.com/overview-1861386m0.md): - Root > Webhooks [Assistant request](https://doc.flireo.com/assistant-request-1861387m0.md): - Root > Webhooks [Tool calls](https://doc.flireo.com/tool-calls-1861388m0.md): - Root > Webhooks [Status update](https://doc.flireo.com/status-update-1861389m0.md): - Root > Webhooks [End of call report](https://doc.flireo.com/end-of-call-report-1861390m0.md): - Root > Webhooks [Security](https://doc.flireo.com/security-1861391m0.md): - Root > Guides [BYOK Setup](https://doc.flireo.com/byok-setup-1861392m0.md): - Root > Guides [Call analysis](https://doc.flireo.com/call-analysis-1861393m0.md): - Root > Guides [Custom Tools](https://doc.flireo.com/custom-tools-1861394m0.md): - Root > Guides [Call Transfers](https://doc.flireo.com/call-transfers-1861395m0.md): - Root > Guides [xAI Realtime Integration](https://doc.flireo.com/xai-realtime-integration-1892920m0.md): - Root > Guides [Analysis templates](https://doc.flireo.com/analysis-templates-1894216m0.md): - Root > Guides [Billing](https://doc.flireo.com/billing-1894217m0.md): - Root > Guides [Error codes](https://doc.flireo.com/error-codes-1894218m0.md): - Root > Guides [Rate limits](https://doc.flireo.com/rate-limits-1894219m0.md): - Root > Guides [Sip Trunks](https://doc.flireo.com/sip-trunks-1894220m0.md): - Root > Guides [Tool templates](https://doc.flireo.com/tool-templates-1894221m0.md): - Root > Guides [Troubleshooting](https://doc.flireo.com/troubleshooting-1894222m0.md): ## API Docs - Root > Agents [List all agents](https://doc.flireo.com/api-reference/assistants/list.md): Retrieve all AI voice agents in your organization. - Root > Agents [Create a new agent](https://doc.flireo.com/api-reference/assistants/create.md): Create a new AI voice agent with custom STT, LLM, and TTS configurations. Only the name is required - defaults will be applied for other settings. - Root > Agents [Get an agent](https://doc.flireo.com/api-reference/assistants/get.md): Retrieve a specific agent by ID. - Root > Agents [Update an agent](https://doc.flireo.com/api-reference/assistants/update.md): Update an existing agent. Only provided fields will be updated. - Root > Agents [Delete an agent](https://doc.flireo.com/api-reference/assistants/delete.md): Delete an agent. Any phone numbers assigned to this agent will have their agent_id set to null. - Root > Tool Templates [List all tool templates](https://doc.flireo.com/api-reference/tools/list.md): Retrieve all tool templates in your organization. - Root > Tool Templates [Create a new tool template](https://doc.flireo.com/api-reference/tools/create.md): Create a new reusable tool template. Tools can be of type 'function' (custom webhook), 'endCall' (built-in), or 'transferCall' (built-in). - Root > Tool Templates [Get a tool template](https://doc.flireo.com/api-reference/tools/get.md): Retrieve a specific tool template by ID. - Root > Tool Templates [Update a tool template](https://doc.flireo.com/api-reference/tools/update.md): Update an existing tool template. Only provided fields will be updated. - Root > Tool Templates [Delete a tool template](https://doc.flireo.com/api-reference/tools/delete.md): Delete a tool template. Note that agents using this tool will continue to work as tools are stored as objects in the agent configuration, not as references. - Root > Numbers [List all phone numbers](https://doc.flireo.com/api-reference/numbers/list.md): Retrieve all phone numbers in your organization with their assigned agents and transfer trunks. - Root > Numbers [Register a phone number](https://doc.flireo.com/api-reference/numbers/create.md): Register a new phone number in your organization. The number must be configured with your SIP provider to forward calls to Flireo. - Root > Numbers [Get a phone number](https://doc.flireo.com/api-reference/numbers/get.md): Retrieve a specific phone number by ID. - Root > Numbers [Update a phone number](https://doc.flireo.com/api-reference/numbers/update.md): Update agent assignment or transfer trunk for a phone number. - Root > Numbers [Delete a phone number](https://doc.flireo.com/api-reference/numbers/delete.md): Remove a phone number from your organization. - Root > Calls [List calls](https://doc.flireo.com/api-reference/calls/list.md): Retrieve call history with optional filtering by status and date range. Returns complete call data including transcripts, analysis results, and metadata. - Root > Calls [Get call by ID](https://doc.flireo.com/api-reference/calls/get.md): Retrieve complete details for a specific call including transcript, analysis results, and all metadata. - Root > Calls [Initiate outbound call](https://doc.flireo.com/api-reference/calls/create.md): Initiate an outbound call from an AI agent to a destination phone number. - Root > Call Control [Send control command to active call](https://doc.flireo.com/api-reference/call-control/create.md): Send real-time commands to an active call. The call must be in "in-progress" status. - Root > Usage [Get usage logs](https://doc.flireo.com/api-reference/usage/get.md): Retrieve your organization's usage logs with billing information and optional date filtering. - Root > SIP Trunks [List SIP trunks](https://doc.flireo.com/api-reference/sip-trunks/list.md): Retrieve all SIP trunks configured for your organization's call transfers. - Root > SIP Trunks [Create a SIP trunk](https://doc.flireo.com/api-reference/sip-trunks/create.md): Create a new SIP trunk for call transfers. Passwords are stored securely in Vault. - Root > SIP Trunks [Get a SIP trunk](https://doc.flireo.com/api-reference/sip-trunks/get.md): Retrieve a specific SIP trunk by ID. - Root > SIP Trunks [Delete a SIP trunk](https://doc.flireo.com/api-reference/sip-trunks/delete.md): Delete a SIP trunk. Any numbers using this trunk for transfers will have their transfer_trunk_id set to null. - Root > Voices [List available voices](https://doc.flireo.com/api-reference/voices/list.md): Returns available voices based on your configuration. - Root > BYOK [Get BYOK configurations](https://doc.flireo.com/api-reference/byok/.md): Retrieve all Bring Your Own Key configurations for your organization. - Root > BYOK [Add BYOK configuration](https://doc.flireo.com/api-reference/byok/create.md): Add or update a Bring Your Own Key configuration. The API key is securely stored in Supabase Vault and only the vault secret ID is stored in the database. - Root > BYOK [Delete BYOK configuration](https://doc.flireo.com/api-reference/byok/delete.md): Remove a Bring Your Own Key configuration. This will delete the secret from Vault and remove the reference from the database. - Root > BYOK [Get BYOK provider configurations](https://doc.flireo.com/api-reference/byok-config/list.md): Retrieve available BYOK providers and their supported models - Root > Domains [Get your domain](https://doc.flireo.com/api-reference/domains/list.md): Retrieve your organization's configured email domain from Resend. Requires a Resend API key to be configured via BYOK (Bring Your Own Key). Returns null if no domain is configured. - Root > Domains [Add a domain](https://doc.flireo.com/api-reference/domains/create.md): Create a custom email domain in Resend for sending notifications from your organization. Requires a Resend API key configured via BYOK. You can only have one domain configured per organization. - Root > Domains [Delete your domain](https://doc.flireo.com/api-reference/domains/delete.md): Remove your organization's configured email domain from both the database and Resend. - Root > Domains [List available Resend domains](https://doc.flireo.com/api-reference/domains/sync/list.md): Fetch all domains configured in your Resend account. Use this to see which domains you can select for your organization's email notifications. Requires a Resend API key configured via BYOK. - Root > Domains [Select and sync a Resend domain](https://doc.flireo.com/api-reference/domains/sync/create.md): Select a domain from your Resend account to use for your organization's email notifications. This syncs the domain configuration to your organization. - Root > Domains [Verify domain DNS records](https://doc.flireo.com/api-reference/domains/verify.md): Trigger domain verification in Resend to check if DNS records are correctly configured. This updates the domain status based on Resend's verification results. - Root > Domains [Refresh domain status](https://doc.flireo.com/api-reference/domains/refresh.md): Fetch the latest domain status from Resend and update your local configuration. Use this to check if verification has completed or if any records need attention. - Root > Webhooks [Dynamic assistant configuration webhook](https://doc.flireo.com/webhook/assistant-request.md): Called **BEFORE** an inbound call is answered, allowing you to: - Root > Webhooks [Tool/Function Call](https://doc.flireo.com/webhook/tool-calls.md): Called when the AI needs to execute a tool/function during the conversation. - Root > Webhooks [Call Status Update](https://doc.flireo.com/webhook/status-update.md): Called when the call status changes. Use this to track call lifecycle. - Root > Webhooks [End of Call Report](https://doc.flireo.com/webhook/end-of-call-report.md): Called after the call ends with a summary and optional structured analysis. - Root > Analysis Templates [List analysis templates](https://doc.flireo.com/api-reference/analysis-templates/list.md): Get all analysis templates for your organization - Root > Analysis Templates [Create analysis template](https://doc.flireo.com/api-reference/analysis-templates/create.md): Create a new analysis template for your organization - Root > Analysis Templates [Get analysis template](https://doc.flireo.com/api-reference/analysis-templates/get.md): Retrieve a specific analysis template by ID - Root > Analysis Templates [Update analysis template](https://doc.flireo.com/api-reference/analysis-templates/update.md): Update an existing analysis template - Root > Analysis Templates [Delete analysis template](https://doc.flireo.com/api-reference/analysis-templates/delete.md): Delete an analysis template - Root > Organization [Get organization information](https://doc.flireo.com/api-reference/account/get.md): Retrieve your organization details including balance, usage statistics, and resource counts. The organization is determined by the API key used for authentication. - Root > Campaigns [List all campaigns](https://doc.flireo.com/api-reference/campaigns/list.md): Retrieve all outbound campaigns in your organization. - Root > Campaigns [Create a campaign](https://doc.flireo.com/api-reference/campaigns/create.md): Create a new outbound calling campaign with leads and schedule. - Root > Campaigns [Get a campaign](https://doc.flireo.com/api-reference/campaigns/get.md): Retrieve a specific campaign by ID. - Root > Campaigns [Update a campaign](https://doc.flireo.com/api-reference/campaigns/update.md): Update campaign settings or status. Set status to `scheduled` to start calling. - Root > Campaigns [Delete a campaign](https://doc.flireo.com/api-reference/campaigns/delete.md): Delete a campaign and all its leads. - Root > Campaigns [List campaign leads](https://doc.flireo.com/api-reference/campaigns/leads/list.md): Retrieve all leads in a campaign. - Root > Campaigns [Add a lead](https://doc.flireo.com/api-reference/campaigns/leads/create.md): Add a new lead to a campaign. - Root > Campaigns [Remove a lead](https://doc.flireo.com/api-reference/campaigns/leads/delete.md): Remove a lead from a campaign. ## Schemas - Root [Error](https://doc.flireo.com/error-11612360d0.md): - Root [Pagination](https://doc.flireo.com/pagination-11612361d0.md): - Root [UUID](https://doc.flireo.com/uuid-11612362d0.md): - Root [Timestamp](https://doc.flireo.com/timestamp-11612363d0.md): - Root [SuccessResponse](https://doc.flireo.com/successresponse-11612364d0.md): - Root [STTConfig](https://doc.flireo.com/sttconfig-11612365d0.md): - Root [LLMConfig](https://doc.flireo.com/llmconfig-11612366d0.md): - Root [TTSConfig](https://doc.flireo.com/ttsconfig-11612367d0.md): - Root [XAIRealtimeConfig](https://doc.flireo.com/xairealtimeconfig-11832803d0.md): - Root [Agent](https://doc.flireo.com/agent-11612368d0.md): - Root [AgentCreate](https://doc.flireo.com/agentcreate-11612369d0.md): - Root [AgentUpdate](https://doc.flireo.com/agentupdate-11612370d0.md): - Root [PhoneNumber](https://doc.flireo.com/phonenumber-11612371d0.md): - Root [PhoneNumberCreate](https://doc.flireo.com/phonenumbercreate-11612372d0.md): - Root [PhoneNumberUpdate](https://doc.flireo.com/phonenumberupdate-11612373d0.md): - Root [Call](https://doc.flireo.com/call-11612374d0.md): - Root [CallControlCommand](https://doc.flireo.com/callcontrolcommand-11612375d0.md): - Root [InjectContextCommand](https://doc.flireo.com/injectcontextcommand-11612376d0.md): - Root [SayCommand](https://doc.flireo.com/saycommand-11612377d0.md): - Root [EndCallCommand](https://doc.flireo.com/endcallcommand-11612378d0.md): - Root [TransferCommand](https://doc.flireo.com/transfercommand-11612379d0.md): - Root [CallControlResponse](https://doc.flireo.com/callcontrolresponse-11612380d0.md): - Root [Account](https://doc.flireo.com/account-11612381d0.md): - Root [OutboundCallRequest](https://doc.flireo.com/outboundcallrequest-11613107d0.md): - Root [OutboundCallResponse](https://doc.flireo.com/outboundcallresponse-11613108d0.md): - Root [UsageLog](https://doc.flireo.com/usagelog-11612382d0.md): - Root [UsageSummary](https://doc.flireo.com/usagesummary-11612383d0.md): - Root [Organization](https://doc.flireo.com/organization-11811819d0.md): - Root [SipTrunk](https://doc.flireo.com/siptrunk-11612384d0.md): - Root [SipTrunkCreate](https://doc.flireo.com/siptrunkcreate-11612385d0.md): - Root [Voice](https://doc.flireo.com/voice-11612898d0.md): - Root [AssistantRequestPayload](https://doc.flireo.com/assistantrequestpayload-11624678d0.md): - Root [CallObject](https://doc.flireo.com/callobject-11624682d0.md): - Root [AssistantRequestResponse](https://doc.flireo.com/assistantrequestresponse-11624679d0.md): - Root [XAIRealtimeVoice](https://doc.flireo.com/xairealtimevoice-11832804d0.md): - Root [Customer](https://doc.flireo.com/customer-11624683d0.md): - Root [AssistantConfigOverride](https://doc.flireo.com/assistantconfigoverride-11624680d0.md): - Root [AnalysisPlan](https://doc.flireo.com/analysisplan-11624681d0.md): - Root [ToolCallsPayload](https://doc.flireo.com/toolcallspayload-11624684d0.md): - Root [ToolCall](https://doc.flireo.com/toolcall-11624685d0.md): - Root [ToolCallsResponse](https://doc.flireo.com/toolcallsresponse-11624686d0.md): - Root [StatusUpdatePayload](https://doc.flireo.com/statusupdatepayload-11624687d0.md): - Root [EndOfCallReportPayload](https://doc.flireo.com/endofcallreportpayload-11624688d0.md): - Root [ToolDefinition](https://doc.flireo.com/tooldefinition-11624689d0.md): - Root [EndCallTool](https://doc.flireo.com/endcalltool-11624690d0.md): - Root [TransferCallTool](https://doc.flireo.com/transfercalltool-11624691d0.md): - Root [WebhookHeaders](https://doc.flireo.com/webhookheaders-11624692d0.md): - Root [XAIRealtimeWebhookNotes](https://doc.flireo.com/xairealtimewebhooknotes-11832805d0.md): - Root [ToolFunctionConfig](https://doc.flireo.com/toolfunctionconfig-11905043d0.md): - Root [ToolTransferConfig](https://doc.flireo.com/tooltransferconfig-11905044d0.md): - Root [ToolTemplate](https://doc.flireo.com/tooltemplate-11905045d0.md): - Root [ToolTemplateCreate](https://doc.flireo.com/tooltemplatecreate-11905046d0.md): - Root [ToolTemplateUpdate](https://doc.flireo.com/tooltemplateupdate-11905047d0.md): - Root [AnalysisTemplate](https://doc.flireo.com/analysistemplate-11906239d0.md): - Root [CreateAnalysisTemplate](https://doc.flireo.com/createanalysistemplate-11906240d0.md): - Root [UpdateAnalysisTemplate](https://doc.flireo.com/updateanalysistemplate-11906241d0.md): - Root [AnalysisTemplateListResponse](https://doc.flireo.com/analysistemplatelistresponse-11906242d0.md): - Root [CampaignLead](https://doc.flireo.com/campaignlead-12128121d0.md): - Root [Campaign](https://doc.flireo.com/campaign-12128122d0.md): - Root [CampaignCreate](https://doc.flireo.com/campaigncreate-12128123d0.md): - Root [CampaignUpdate](https://doc.flireo.com/campaignupdate-12128124d0.md): - Root [CampaignLeadCreate](https://doc.flireo.com/campaignleadcreate-12128125d0.md):