---

name: retellai-rate-limits description: "Retell AI rate limits \u2014 AI voice agent and phone call automation.\n
Use when working with Retell AI for voice agents, phone calls, or telephony.\nTrigger
\ with phrases like "retell rate limits", "retellai-rate-limits", "voice agent"
.\n" allowed-tools: Read, Write, Edit, Bash(npm:), Bash(curl:), Grep version: 1.9.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io tags:

• saas
• retellai
• voice
• telephony
• ai-agents compatibility: Designed for Claude Code

---

Retell AI Rate Limits

Overview

Implementation patterns for Retell AI rate limits — voice agent and telephony platform.

Prerequisites

• Completed retellai-install-auth setup

Instructions

Step 1: SDK Pattern

import Retell from 'retell-sdk';
const retell = new Retell({ apiKey: process.env.RETELL_API_KEY! });

const agents = await retell.agent.list();
console.log(`Agents: ${agents.length}`);

Output

• Retell AI integration for rate limits

Error Handling

Error	Cause	Solution
401 Unauthorized	Invalid API key	Check RETELL_API_KEY
429 Rate Limited	Too many requests	Implement backoff
400 Bad Request	Invalid parameters	Check API documentation

Examples

Handle a burst without retrying calls indefinitely

When the API returns a rate-limit response, place only the idempotent request metadata in a bounded queue and honor the provider retry guidance before the next attempt. Track queue age, retry count, and error class; do not retry an ambiguous call-creation request until its call identifier is checked. Alert an operator when the queue age exceeds the service target, and shed nonessential work rather than allowing retries to amplify the burst.

Resources

• Retell AI Documentation
• retell-sdk npm

Next Steps

See related Retell AI skills for more workflows.