​
Create a Squad

​
Prerequisites

Before creating a squad, you need:
  • At least 2 published assistants
  • Each assistant configured for its specific role

​
Steps

  1. Create your individual assistants first (e.g., Greeter, Specialist, Closer)
  2. Publish each one
  3. Use the Squads API to create the squad:
curl -X POST https://api.volang.ai/v2/squads/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Service Team",
    "routing_strategy": "sequential",
    "assistant_ids": [1, 2, 3],
    "primary_assistant_id": 1,
    "handoff_rules": {
      "escalation_triggers": ["urgent", "complaint", "manager"],
      "fallback_assistant": 3
    }
  }'
Squad Creation

​
Configuration Options

FieldRequiredDescription
nameYesDescriptive name for the squad
routing_strategyYessequential, parallel, or conditional
assistant_idsYesList of assistant IDs to include
primary_assistant_idNoEntry point assistant (first to handle calls)
handoff_rulesNoRules for transferring between assistants

​
Example: Customer Support Squad

{
  "name": "Customer Support Squad",
  "routing_strategy": "conditional",
  "assistant_ids": [10, 11, 12],
  "primary_assistant_id": 10,
  "handoff_rules": {
    "escalation_triggers": ["urgent", "complaint"],
    "fallback_assistant": 12,
    "routing_rules": {
      "billing": 11,
      "technical": 12,
      "general": 10
    }
  }
}
This creates a squad where:
  • Assistant 10 (Greeter) handles all incoming calls
  • Billing questions route to Assistant 11
  • Technical issues route to Assistant 12
  • Urgent/complaint triggers escalate to Assistant 12

​
After Creation

The squad is automatically synced to the voice engine. You can then:
  • Assign it to a phone number (instead of a single assistant)
  • Monitor its performance in the Sessions page

​
Updating a Squad

curl -X PATCH https://api.volang.ai/v2/squads/1 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Squad Name",
    "assistant_ids": [10, 11, 12, 13]
  }'
Changes are synced to the voice engine automatically.