Vapi

Tools

• Create Analytics Queries

  Tool to create and execute analytics queries on VAPI data. Use when you need to analyze call or subscription metrics with aggregations like count, sum, average, min, or max. Supports grouping by various dimensions and time-based analysis wi

• Create Assistant

  Tool to create a new Vapi assistant with specified transcriber, voice, and AI model configurations. Use when setting up a conversational AI assistant for voice interactions. The assistant requires transcription (speech-to-text), voice (text

• Create Eval

  Tool to create an eval for testing conversation flows. Use when you need to validate that an AI assistant responds correctly to specific conversation scenarios.

• Create Monitoring Policy

  Tool to create a monitoring policy in VAPI. Use when you need to set up automated monitoring rules based on thresholds and time windows. Policies can trigger alerts based on event counts or percentages over a specified lookback window.

• Create OpenAI Chat

  Tool to create an OpenAI-compatible chat using the Vapi API. Use when you need to send a chat message to an assistant or squad and receive a response. Supports both streaming and non-streaming modes.

• Create Phone Number

  Tool to create a phone number with VAPI. Use when you need to provision a new phone number for voice AI applications. Supports multiple providers (VAPI, Twilio, Vonage, Telnyx, BYO). Required parameters vary by provider.

• Create Phone Number

  Tool to create a phone number with Vapi. Supports multiple providers including byo-phone-number, twilio, vonage, vapi, and telnyx. Use this to provision new phone numbers for handling voice calls. For vapi provider, only provider field is r

• Create Provider Resource

  Tool to create an 11Labs pronunciation dictionary resource. Use when you need to define custom pronunciations for specific terms or acronyms in voice synthesis.

• Create Scorecard

  Tool to create a scorecard for observability and evaluation. Use when setting up metrics to evaluate assistant performance based on structured outputs. Scorecards contain metrics with conditions that calculate normalized scores on a 100-poi

• Create Session

  Tool to create a new session in Vapi. Use when you need to establish a persistent conversation context that can span multiple chats. Sessions automatically expire after 24 hours.

• Delete Call

  destructive

  Tool to delete a call by its unique identifier. Use when you need to remove call data from the system. Returns the deleted call object with all its associated data.

• Delete Chat

  destructive

  Tool to delete a chat by its ID from Vapi. Use when you need to permanently remove a chat conversation.

• Delete Eval

  destructive

  Tool to delete an eval by ID. Use when you need to permanently remove an eval from the system.

• Delete Eval Run

  destructive

  Tool to delete an eval run by its ID from Vapi. Use when you need to permanently remove an evaluation run.

• Delete Phone Number

  destructive

  Tool to delete a phone number from Vapi. Use when you need to remove a phone number from your Vapi organization. Returns the deleted phone number object.

• Get Assistant

  Tool to retrieve a specific assistant by ID from Vapi. Use when you need to fetch details about an existing assistant.

• Get Call

  Tool to fetch call details by ID. Use when you have a call ID and need full call information including status, duration, costs, messages, and recordings.

• Get Chat

  Tool to fetch chat details by ID. Use when you have a chat ID and need full chat information including messages, costs, and configuration.

• Get Eval

  Tool to retrieve an eval by its ID. Use when you need to fetch details about a specific eval including its mock conversation messages and metadata.

• Get File

  Tool to retrieve a file by its ID from Vapi. Use when you need to get details about a specific file including its status, metadata, storage location, and timestamps.

• Get Insights

  Tool to retrieve insights from Vapi. Use when you need to fetch insight data with optional filtering by ID, timestamps, or pagination. Returns a paginated list of insights with metadata.

• Get Insights

  Tool to retrieve insights from VAPI. Use when you need to list insights with optional filtering by ID, creation date, or update date. Supports pagination and sorting.

• Get Observability Scorecard

  Tool to list observability scorecards with optional filtering and pagination. Use when you need to retrieve scorecards for monitoring or analysis.

• Get Tool

  Tool to fetch tool details by ID. Use when you have a tool ID and need full tool configuration including type, messages, function definitions, and server settings.

• List Assistants

  Tool to list all assistants in your VAPI organization. Use when you need to retrieve information about configured assistants. Supports filtering by creation and update timestamps.

• List Calls

  Tool to list calls from Vapi. Use when you need to retrieve multiple calls with optional filtering by id, assistantId, phoneNumberId, or date ranges. Returns an array of call objects with details including status, costs, messages, and artif

• List Chats

  Tool to retrieve a list of chat conversations from VAPI. Use when you need to view existing chats, optionally filtered by assistant, squad, session, or time range. Supports pagination and sorting for efficient retrieval of large chat histor

• List Evals

  Tool to retrieve a paginated list of evals from Vapi. Use when you need to list or search evals with optional filtering by creation/update timestamps.

• List Monitoring Policies

  Tool to retrieve monitoring policies from Vapi. Use when you need to list, filter, or search for monitoring policies configured in the organization. Supports filtering by policy ID, severity level, monitor ID, and date ranges for creation/u

• List Provider Resources

  Tool to retrieve provider resources from Vapi (e.g., 11labs pronunciation dictionaries). Use when you need to list or search provider-specific resources with optional filtering by timestamps.

• List Provider Resources

  Tool to list provider resources from Vapi. Use when you need to retrieve pronunciation dictionaries or other resources from providers like 11labs or Cartesia.

• List Scorecards

  Tool to retrieve a paginated list of scorecards from Vapi. Use when you need to list or search scorecards with optional filtering by creation/update timestamps.

• List Sessions

  Tool to retrieve a paginated list of sessions from VAPI. Use when you need to list sessions with optional filtering by session ID, name, assistant, squad, or workflow. Supports pagination, sorting, and timestamp-based filtering.

• List Structured Outputs

  Tool to list structured outputs with optional filtering. Use when you need to retrieve structured output configurations with pagination support. Supports filtering by ID, name, timestamps, and includes pagination controls.

• List Structured Outputs

  Tool to list structured outputs with optional filtering and pagination. Use when you need to retrieve structured output configurations from Vapi.

• Test Code Tool Execution

  Tool to test TypeScript code execution in Vapi's code tool environment. Use when validating code before deploying it as a tool.

• Update Assistant

  Tool to update an existing Vapi assistant configuration. Use when you need to modify assistant properties such as name, voice settings, transcriber configuration, model settings, messages, or other behavior parameters. Only include fields y

• Update Eval

  Tool to update an existing eval in Vapi. Use when you need to modify eval properties like name, description, type, or mock conversation messages.

• Update Insight

  Tool to update an existing insight configuration in VAPI. Use when you need to modify insight properties like name, queries, time range, or visualization settings. Supports all four insight types (bar, pie, line, text) with type-specific co

• Update Phone Number

  Tool to update an existing phone number configuration in VAPI. Use when you need to modify phone number settings such as name, associated assistant/workflow, or provider-specific configurations.

• Update Tool

  Tool to update an existing Vapi tool configuration. Use when you need to modify tool properties such as function definitions, server settings, messages, or other tool-specific parameters.

• Upload File

  Tool to upload a file to Vapi Knowledge Base. Use when you need to add files for AI assistants to reference. Returns file metadata including ID, storage URLs, and processing status.

Works well with

How Switchy teams use it

Starter prompts

@Vapi create an assistant named 'Support Bot' using the Deepgram transcriber and ElevenLabs voice. Configure it to answer common product questions and escalate complex issues to a human agent.

@Vapi create an analytics query for the last 7 days showing total call count, average call duration, and percentage of calls that ended successfully. Group results by day.

@Vapi provision a new phone number using Twilio in the 415 area code. Assign it to the 'Q1 Outreach' assistant and enable call recording.

@Vapi create an eval that tests whether the 'Booking Assistant' correctly captures a customer's preferred appointment time and confirms availability for next Tuesday at 2pm.

@Vapi create a monitoring policy that triggers an alert if the call failure rate exceeds 5% over any 1-hour window, or if average call duration drops below 30 seconds.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Use-case deep-dives

Frequently asked