Skill Store 33

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-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 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.

Download SKILL.md · Markdown version

Details

Publisher
jeremylongshore
Category
Software Development › DevOps & cloud
License
MIT
Updated
2026-10-19

References

More from jeremylongshore