Squads

A squad is a voice-only routing layer for multi-agent experiences. One entrypoint agent starts the conversation, then transfer rules determine when the call should move to a different specialist.

When to Use a Squad

Use a squad when one conversation may need multiple specialists, such as:

Front desk to billing to scheduling
Qualification to closer
General support to product-specific experts

If one agent can handle the full conversation alone, keep the design simpler and skip squads.

Squad Model

Entrypoint agent: the first voice agent that answers the conversation
Transfer rules: routing rules that define which agent can hand off to which other agent

Only call agents belong in squads.

Create a Squad

curl -X POST "https://prod.featherhq.com/api/v1/squads" \
  -H "X-API-Key: $FEATHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Patient access squad",
    "description": "Routes calls between front desk, billing, and scheduling",
    "entrypointAgentId": "ENTRYPOINT_CALL_AGENT_ID"
  }'

Add a Transfer Rule

curl -X POST "https://prod.featherhq.com/api/v1/squads/SQUAD_ID/transfer-rules" \
  -H "X-API-Key: $FEATHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromAgentId": "ENTRYPOINT_CALL_AGENT_ID",
    "toAgentId": "SCHEDULING_AGENT_ID",
    "allowManualTrigger": true,
    "toolDescription": "Transfer the call to the scheduling specialist when the caller is ready to book.",
    "variables": [
      {
        "name": "appointmentType",
        "description": "Requested appointment type",
        "required": false
      }
    ],
    "speakBeforeTransfer": "I am connecting you to our scheduling specialist now."
  }'

Best Practices

Give each squad member a distinct job.
Keep transfer descriptions short and operational.
Pass only the variables the receiving agent needs.
Start with a small routing graph before building a large specialist network.

Phone Numbers

Use a squad as the inbound destination for a phone number.

Agents

Design specialized voice agents for each handoff.

Squad API

Manage squads and transfer rules.

Dispatch Squad

Launch a routed conversation directly.

Knowledge Base

Calendars

Getting Started

Core Concepts

How-To Guides

When to Use a Squad

Squad Model

Create a Squad

Add a Transfer Rule

Best Practices

Phone Numbers

Agents

Squad API

Dispatch Squad

​When to Use a Squad

​Squad Model

​Create a Squad

​Add a Transfer Rule

​Best Practices

​Related Concepts

Phone Numbers

Agents

Squad API

Dispatch Squad

When to Use a Squad

Squad Model

Create a Squad

Add a Transfer Rule

Best Practices

Related Concepts