# Retellai Incident Runbook

> Retell AI incident response runbook for voice agents and phone call telephony, using the retell-sdk

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.

- Page: https://ss33.ai/skills/jeremylongshore/retellai-incident-runbook-7991352371
- Publisher: jeremylongshore
- Category: [Software Development](https://ss33.ai/skills/category/software-development-t44z8z) › [DevOps & cloud](https://ss33.ai/skills/category/software-development-t44z8z/devops-and-cloud-unkt50)
- License: MIT
- Source: https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/6cc8e76343714d8807b4a5f1aa604b7ede5e497f/plugins/saas-packs/retellai-pack/skills/retellai-incident-runbook/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/jeremylongshore/retellai-incident-runbook-7991352371

# 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

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

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