Skip to main content
Limits, Data Retention and Policies

Platform Limits Reference

The limits in one place: knowledge bases, extractions, the AI Agent Builder, CSV imports, tools, SMS, widgets, call lines, the API and plan caps.

Written By voiceaiwrapper

Last updated 26 days ago

This page lists the limits in VoiceAIWrapper so you can plan a build before you hit one. Use it when you're sizing a knowledge base, importing a large lead list, designing a widget or writing an integration against the API.

There are two kinds of limit:

  • Fixed limits are the same on every plan. They keep calls fast and the platform stable. Most of them apply to VAW Native, the built-in voice engine.

  • Plan caps depend on your plan: campaigns, client accounts, team members, client forms, and Stripe products and packs. They're covered at the end of this page.

On Vapi, Retell AI and ElevenLabs Pods (BYOK Pods), your provider account sets most limits for agents, knowledge and tools. The VoiceAIWrapper limits that still apply there are CSV imports, the API, plan caps and your Pod's call lines.

Knowledge bases

Limit

Value

Knowledge bases per Pod

25

Documents per knowledge base

200

Knowledge bases attached to one agent

5

File size per upload

25 MB

Pasted text per document

500,000 characters

Pages per site crawl (Also add every page underneath this one)

500 pages, up to 5 levels deep

Results per question

1 to 20 (default 4)

Web pages re-sync once a day. For how documents are read and synced, see How Knowledge Bases Work.

Call analysis and Call Data Extractions

Limit

Value

Call Data Extractions per Pod

50

Extractions running for one agent

10

Calls in one backfill (Run backfill)

100 ended calls

Size of an extraction's fields (schema)

16 KB

Items in a Checklist call-success rubric

10

Custom summary instructions

1,000 characters

Backfills and analysis runs use AI credits. See Extraction Templates, Run Conditions and Backfills.

AI Agent Builder (VAW Assistant)

Limit

Value

Sites read with Read the site

30 per day per organization

Agents created with the builder

30 per day per organization

Time allowed to read a site or create the agent

5 minutes each

When you reach a daily limit you'll see "You've reached today's limit for reading websites. Try again tomorrow." or "You've reached today's limit for creating agents this way. Try again tomorrow." Agents you create from scratch don't count toward these limits. See Create an Agent with the AI Agent Builder.

Agent settings (VAW Native)

Setting

Limit

Agent name

255 characters

Maximum call length

1 to 240 minutes

Boosted words

25 words, 40 characters each

Passed-in call data (variables you send with a call)

4,096 bytes in total

Closing phrases (End conversation)

20 phrases, 100 characters each

When to end the conversation guidance

1,000 characters

Transfer call and Send SMS

These built-in tools work on phone calls only.

Tool

Limit

Value

Transfer call

Destinations per agent

10

Transfer call

Ring time before giving up

5 to 120 seconds (default 30)

Transfer call

Destination name

64 characters

Transfer call

Warm transfer handoff message

1,000 characters

Send SMS

Message length

1,600 characters

Send SMS

Texts per call

1 to 10 (default 2)

Send SMS

Blanks in a set sentence

10

Send SMS

Brief when the agent writes the text

2,000 characters

Long texts are split into several SMS segments by the carrier, and each segment is billed by Twilio. See Send Text Messages During a Call.

Custom tools

Limit

Value

Tool description

2,000 characters

Timeout

1 to 30 seconds (default 10)

Run test

10 tests per minute

Size of a tool definition

256 KB

Function name (per-agent alias)

64 characters

Web widgets and website chat (VAW Native)

Limit

Value

Conversations per visitor per hour

1 to 60 (default 10)

Page variables a widget accepts

20 names

Length of one chat message

8,000 characters

Visitor messages in one chat

150

Chat closes when idle

After the widget's Chat Inactivity Timeout (minutes), 1 to 60 (30 if not set)

Longest a chat stays open

12 hours after it starts

Website chats open at once, per Pod (set in the Pod's Set Concurrency step)

1 to 500 (default 20)

When a chat reaches its message limit, the visitor sees "This chat has reached its message limit. Start a new chat to keep going." Website chats don't use call lines. See Visitor Limits and Page Variables.

Call lines (concurrency)

Each Pod has a number of call lines: how many calls can run at the same time. You split them between inbound and outbound calls.

  • VAW Native: Pay-as-you-go includes 6 concurrent calls and Growth includes 10. Additional concurrency on either plan is $10/line/month or $100/line/year. The platform manages the total, and you choose the inbound/outbound split. Check your actual total in the Pod’s Set Concurrency step.

  • Vapi, Retell AI and ElevenLabs: the limit you enter when you connect the Pod should match the concurrency of your provider account.

A VAW Native call that arrives when every line is busy ends with Concurrency limit reached. See Split Concurrency Between Inbound and Outbound Calls.

Campaigns and leads

Limit

Value

Rows per CSV lead import

30,000

CSV file size

20 MB

Phone number in a CSV row

7 to 15 digits, plus a separate country code

Need more than 30,000 leads? Split the file and import it in parts, or send leads through the API. See Import Leads from a CSV File.

API rate limits

Every endpoint of the VoiceAIWrapper API (leads, campaigns, clients, Pods, web widgets, form submissions and external billing) allows 100 requests per minute for each API key. The count is kept separately for each endpoint, so a busy leads integration doesn't use up the allowance for campaigns.

When you go over, the API answers with HTTP status 429 and this body:

{
  "message": "Rate limit exceeded. Please try again later.",
  "error": "RATE_LIMIT_EXCEEDED"
}

Wait until the next minute and retry. To add many leads at once, use the bulk leads endpoint: one request can carry a whole list. See API Reference Overview and Rate Limits.

Webhooks VAW Native sends

Limit

Value

Time your server has to answer an agent webhook

10 seconds

Delivery attempts

4 in total: the first try, then retries 1 minute, 4 minutes and 10 minutes after the previous try

Retried when your server answers

408, 429, 500, 502, 503 or 504 (or doesn't answer)

Time your server has to answer the phone number Inbound webhook

5 seconds, one attempt only (no retries)

Recording links in webhook payloads

Work for 7 days

See VAW Native Agent Webhooks: Events and Delivery.

Plan caps

These limits depend on your plan and add-ons:

Cap

What counts

Voice campaigns

Enabled campaigns across your whole organization. Disabled campaigns don't count.

Client accounts

Every client account, enabled or disabled, until you delete it.

Team members (including you)

Everyone in your organization, including you and anyone you've invited who hasn't joined yet.

Client forms

Forms in the client portal.

Stripe products & packs

Active billing plans and usage packs you sell through Stripe. Archived ones don't count.

Pay-as-you-go and Growth each allow 5 campaigns per client account. Pay-as-you-go includes 1 client account and Growth includes 3; extra client-account capacity increases the campaign allowance. Check Settings β†’ Billing for your Scale campaign allowance.

To see where you stand on campaigns, open Add Campaign. The wizard shows "{usage} of {max} campaigns used", then "1 campaign slot left ({usage}/{max} used)", then "Campaign limit reached ({usage}/{max})" when you're out. When you hit any cap, an upgrade prompt opens and shows Used on your plan with your usage and limit. From there you can upgrade, add an add-on where one exists, or chat with us. See Plan Limits and Upgrade Prompts.

Nothing is deleted or switched off when you reach a cap. You can't add more until you upgrade or remove something.

Frequently asked questions

Plan caps can be raised by moving to a bigger plan or buying add-ons such as extra client accounts or team members. For anything else, open Need help? β†’ Help Chat and describe what you're building and which limit you're hitting.

No. VoiceAIWrapper doesn't cap calls per day or the number of leads you store. What limits volume is your call lines, your campaign's dialing rules and, on VAW Native, your AI credit balance.

You sent more than 100 requests in a minute to the same endpoint with the same API key. Slow down, retry after the minute resets, or batch leads into a bulk request. See 'Concurrency Limit Reached' and '429 Too Many Requests'.

Related articles