# Retellai Rate Limits

> Retell AI rate limits — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like "retell rate limits", "retellai-rate-limits", "voice agent".

- Skill: `gabrielmoreira/retellai-rate-limits` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/retellai-rate-limits`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/retellai-rate-limits/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/retellai-rate-limits

---

# 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

```typescript
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](https://docs.retellai.com)
- [retell-sdk npm](https://www.npmjs.com/package/retell-sdk)

## Next Steps

See related Retell AI skills for more workflows.