retellai-rate-limits

Implement Retell AI rate limiting, backoff, and idempotency patterns. Use when handling rate limit errors, implementing retry logic, or optimizing API request throughput for Retell AI. Trigger with ph

SKILL.md

GitHub

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

Next Steps

See related Retell AI skills for more workflows.