Retellai Incident Runbook
Retell AI incident response runbook for voice agents and phone call telephony, using the retell-sdk
by jeremylongshore · MIT
The skill
Retell AI incident response runbook for voice agents and phone call telephony, using the retell-sdk in TypeScript. Covers containing failed-transfer spikes by freezing agent promotions, routing calls to a last known-good agent or human queue, capturing call IDs, agent versions and response codes, and rolling back. Use when handling a production incident with Retell AI voice agents, phone calls or call transfers, or when setting up the RETELL_API_KEY integration that this runbook depends on.
Retell AI Incident Runbook
Overview
Implementation patterns for Retell AI incident runbook — voice agent and telephony platform.
Prerequisites
- Completed
retellai-install-authsetup
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 incident runbook
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
Contain a spike in failed transfers
When transfer failures cross the alert threshold, freeze new agent promotions and route new calls to the last known-good agent or human queue. Capture call identifiers, agent versions, transfer destinations, and response codes without copying recordings into the incident channel. Compare a synthetic preview call with the affected production version, make one reversible routing change, and document the rollback condition before restoring normal traffic.
Resources
Next Steps
See related Retell AI skills for more workflows.
Use this skill
Connect your agent to the Skill Store MCP server and ask for it by ref: jeremylongshore/retellai-incident-runbook-7991352371.
Details
- Publisher
- jeremylongshore
- Category
- Software Development › DevOps & cloud
- License
- MIT
- Updated
- 2026-10-19
References
More from jeremylongshore
- Agency Os Notion-as-source-of-truth dispatch board for running your work like an AI agency.
- Audit Use when the user wants a code review on recent changes — quality, spec, security, or performance…
- Background Use when the user wants to see, inspect, cancel, or prune background agents fired during prior ch…
- Bridge Use when the user wants hyperflow's behavioral rules to apply outside the terminal CLI — in Claud…