Skip to main content
POST
/
squads
Create Squad
curl --request POST \
  --url https://api.example.com/squads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "members": [
    {
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "role": "<string>",
      "specialization": "<string>",
      "skills": [
        "<string>"
      ],
      "priority": 1,
      "max_concurrent": 123,
      "working_hours": {}
    }
  ],
  "description": "<string>",
  "transfer_rules": [
    {
      "to_member": "<string>",
      "conditions": [
        "<string>"
      ],
      "from_member": "<string>",
      "priority": 1,
      "transfer_type": "warm",
      "context_fields": [
        "<string>"
      ]
    }
  ],
  "routing_strategy": "round_robin",
  "default_member": "<string>",
  "agents": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "agents": [
    {}
  ],
  "routing_strategy": "<string>",
  "status": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "transfer_rules": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.mrassistant.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Squad creation model with intelligent routing support.

name
string
required
Required string length: 1 - 255
members
SquadMember · object[]
required

Squad members with configurations

Minimum array length: 1
description
string | null
transfer_rules
TransferRule · object[] | null

Intelligent transfer rules

routing_strategy
string
default:round_robin
Pattern: ^(round_robin|load_balanced|skill_based|sentiment_based|context_aware)$
default_member
string | null

Default member role for initial routing

agents
string<uuid>[] | null

Legacy: Simple agent ID list

Response

Successful Response

Squad response model.

id
string<uuid>
required
tenant_id
string<uuid>
required
name
string
required
agents
Agents · object[]
required
routing_strategy
string
required
status
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
description
string | null
transfer_rules
Transfer Rules · object