Squad-uri

9 endpoint-uri. Fiecare cale de mai jos este relativă la URL-ul de bază al API-ului și include deja prefixul /api/v1 — vezi convențiile pentru autentificare, paginare, erori și idempotență.

	Endpoint
GET	`/squads`	Lists the organization's squads with their members and routing table loaded
POST	`/squads`	Creates a draft squad together with its members and routing table in one transaction
GET	`/squads/{squad}`	Returns one squad with its members and routing table
PUT	`/squads/{squad}`	Updates a squad and, when supplied, replaces its member list and routing table wholesale
DELETE	`/squads/{squad}`	Deletes a squad along with its routing table and membership
POST	`/squads/{squad}/publish`	Validates the squad's routing graph and freezes it into a new version, returning its id and number
POST	`/squads/{squad}/resolve-handoff`	Dry-runs the routing table against a hypothetical signal and returns the handoff decision it would make
GET	`/squads/{squad}/snapshot`	Returns the routing graph the gateway consumes: squad settings, members and every route in priority order
GET	`/squads/{squad}/validate`	Runs the publish-time routing checks without publishing and returns the error list

Endpoint-uri

Lists the organization's squads with their members and routing table loaded

GET/squads

Necesită squad.read.
Only limit is honoured (default 25, capped at 100); there is no search or status filter.

Parametri de interogare

Nume	Tip	Obligatoriu	Note
`limit`	integer	—	default `25`

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/squads?limit=25" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads?limit=25`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads?limit=25');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/squads?limit=25",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	Paginated set of `SquadResource`

Erori

Status	Când apare
`403`	The key lacks squad.read

Exemplu de răspuns, generat din schemă:

json

{
  "data": [
    {
      "id": "01JQ0000000000000000000000",
      "object": "string",
      "name": "Support Line",
      "description": "string",
      "status": "string",
      "is_published": true,
      "version": 1,
      "current_version_id": "01JQ0000000000000000000000",
      "entry_assistant_id": "01JQ0000000000000000000000",
      "handoff_context_mode": "string",
      "handoff_context_size": 1,
      "handoff_extract_variables": {},
      "silent_handoff": true,
      "handoff_message": "string",
      "metadata": {},
      "members": [],
      "routes": [],
      "created_at": "2026-01-01T12:00:00+00:00",
      "updated_at": "2026-01-01T12:00:00+00:00"
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {}
    ],
    "path": "string",
    "per_page": 25,
    "to": 1,
    "total": 1
  }
}

Creates a draft squad together with its members and routing table in one transaction

POST/squads

Necesită squad.write.

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`name`	string	da	max 255 chars
`description`	string \| null	—	max 255 chars
`entry_assistant_id`	string \| null	—
`handoff_context_mode`	`all_messages` · `last_n` · `user_only` · `user_assistant` · `summary` · `none` \| null	—
`handoff_context_size`	integer \| null	—	min 1. max 200
`handoff_extract_variables`	string[] \| null	—
`silent_handoff`	boolean \| null	—
`handoff_message`	string \| null	—	max 2000 chars
`metadata`	string[] \| null	—
`members`	object[] \| null	—
`routes`	object[] \| null	—

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/squads" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "name": "Support Line",
       "entry_assistant_id": "01JQ0000000000000000000000",
       "handoff_context_mode": "all_messages",
       "handoff_context_size": 1,
       "silent_handoff": true,
       "members": [
         {
           "assistant_id": "01JQ0000000000000000000000",
           "role": "entry",
           "alias": "string",
           "pin_mode": "latest",
           "assistant_version_id": "01JQ0000000000000000000000",
           "enabled": true
         }
       ],
       "routes": [
         {
           "id": "01JQ0000000000000000000000",
           "name": "Support Line",
           "trigger": "tool",
           "trigger_value": "string",
           "condition": [],
           "destination_type": "assistant",
           "destination_assistant_id": "01JQ0000000000000000000000",
           "destination_squad_id": "01JQ0000000000000000000000",
           "destination_queue_id": "01JQ0000000000000000000000",
           "destination_expression": "string",
           "context_mode": "all_messages",
           "context_size": 1,
           "extract_variables": [],
           "silent": true,
           "message": "string",
           "priority": 1,
           "enabled": true
         }
       ]
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Support Line",
    "entry_assistant_id": "01JQ0000000000000000000000",
    "handoff_context_mode": "all_messages",
    "handoff_context_size": 1,
    "silent_handoff": true,
    "members": [
      {
        "assistant_id": "01JQ0000000000000000000000",
        "role": "entry",
        "alias": "string",
        "pin_mode": "latest",
        "assistant_version_id": "01JQ0000000000000000000000",
        "enabled": true
      }
    ],
    "routes": [
      {
        "id": "01JQ0000000000000000000000",
        "name": "Support Line",
        "trigger": "tool",
        "trigger_value": "string",
        "condition": [],
        "destination_type": "assistant",
        "destination_assistant_id": "01JQ0000000000000000000000",
        "destination_squad_id": "01JQ0000000000000000000000",
        "destination_queue_id": "01JQ0000000000000000000000",
        "destination_expression": "string",
        "context_mode": "all_messages",
        "context_size": 1,
        "extract_variables": [],
        "silent": true,
        "message": "string",
        "priority": 1,
        "enabled": true
      }
    ]
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Support Line',
    'entry_assistant_id' => '01JQ0000000000000000000000',
    'handoff_context_mode' => 'all_messages',
    'handoff_context_size' => 1,
    'silent_handoff' => true,
    'members' => [
        [
            'assistant_id' => '01JQ0000000000000000000000',
            'role' => 'entry',
            'alias' => 'string',
            'pin_mode' => 'latest',
            'assistant_version_id' => '01JQ0000000000000000000000',
            'enabled' => true,
        ],
    ],
    'routes' => [
        [
            'id' => '01JQ0000000000000000000000',
            'name' => 'Support Line',
            'trigger' => 'tool',
            'trigger_value' => 'string',
            'condition' => [],
            'destination_type' => 'assistant',
            'destination_assistant_id' => '01JQ0000000000000000000000',
            'destination_squad_id' => '01JQ0000000000000000000000',
            'destination_queue_id' => '01JQ0000000000000000000000',
            'destination_expression' => 'string',
            'context_mode' => 'all_messages',
            'context_size' => 1,
            'extract_variables' => [],
            'silent' => true,
            'message' => 'string',
            'priority' => 1,
            'enabled' => true,
        ],
    ],
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/squads",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "name": "Support Line",
      "entry_assistant_id": "01JQ0000000000000000000000",
      "handoff_context_mode": "all_messages",
      "handoff_context_size": 1,
      "silent_handoff": True,
      "members": [
        {
          "assistant_id": "01JQ0000000000000000000000",
          "role": "entry",
          "alias": "string",
          "pin_mode": "latest",
          "assistant_version_id": "01JQ0000000000000000000000",
          "enabled": True
        }
      ],
      "routes": [
        {
          "id": "01JQ0000000000000000000000",
          "name": "Support Line",
          "trigger": "tool",
          "trigger_value": "string",
          "condition": [],
          "destination_type": "assistant",
          "destination_assistant_id": "01JQ0000000000000000000000",
          "destination_squad_id": "01JQ0000000000000000000000",
          "destination_queue_id": "01JQ0000000000000000000000",
          "destination_expression": "string",
          "context_mode": "all_messages",
          "context_size": 1,
          "extract_variables": [],
          "silent": True,
          "message": "string",
          "priority": 1,
          "enabled": True
        }
      ]
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`201`	`SquadResource`

Erori

Status	Când apare
`403`	The key lacks squad.write
`422`	Validation failed, or a referenced assistant/squad is not in this organization

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "id": "01JQ0000000000000000000000",
    "object": "string",
    "name": "Support Line",
    "description": "string",
    "status": "string",
    "is_published": true,
    "version": 1,
    "current_version_id": "01JQ0000000000000000000000",
    "entry_assistant_id": "01JQ0000000000000000000000",
    "handoff_context_mode": "string",
    "handoff_context_size": 1,
    "handoff_extract_variables": {},
    "silent_handoff": true,
    "handoff_message": "string",
    "metadata": {},
    "members": [
      {}
    ],
    "routes": [
      {}
    ],
    "created_at": "2026-01-01T12:00:00+00:00",
    "updated_at": "2026-01-01T12:00:00+00:00"
  }
}

Returns one squad with its members and routing table

GET/squads/{squad}

Necesită squad.read.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`squad`	string	da	The squad ID

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/squads/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads/01JQ0000000000000000000000`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/squads/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`SquadResource`

Erori

Status	Când apare
`403`	The key lacks squad.read
`404`	No such squad in this organization

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "id": "01JQ0000000000000000000000",
    "object": "string",
    "name": "Support Line",
    "description": "string",
    "status": "string",
    "is_published": true,
    "version": 1,
    "current_version_id": "01JQ0000000000000000000000",
    "entry_assistant_id": "01JQ0000000000000000000000",
    "handoff_context_mode": "string",
    "handoff_context_size": 1,
    "handoff_extract_variables": {},
    "silent_handoff": true,
    "handoff_message": "string",
    "metadata": {},
    "members": [
      {}
    ],
    "routes": [
      {}
    ],
    "created_at": "2026-01-01T12:00:00+00:00",
    "updated_at": "2026-01-01T12:00:00+00:00"
  }
}

Updates a squad and, when supplied, replaces its member list and routing table wholesale

PUT/squads/{squad}

Necesită squad.write.
PATCH este acceptat pe aceeași cale, cu același corp.
members and routes are synced only when the key is present, and then they replace the existing set rather than merging.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`squad`	string	da	The squad ID

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`name`	string	—	max 255 chars
`description`	string \| null	—	max 255 chars
`entry_assistant_id`	string \| null	—
`handoff_context_mode`	`all_messages` · `last_n` · `user_only` · `user_assistant` · `summary` · `none` \| null	—
`handoff_context_size`	integer \| null	—	min 1. max 200
`handoff_extract_variables`	string[] \| null	—
`silent_handoff`	boolean \| null	—
`handoff_message`	string \| null	—	max 2000 chars
`metadata`	string[] \| null	—
`members`	object[] \| null	—
`routes`	object[] \| null	—

cURLJavaScriptPHPPython

bash

curl -X PUT "$CALLAGENT_API_URL/squads/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "name": "Support Line",
       "entry_assistant_id": "01JQ0000000000000000000000",
       "handoff_context_mode": "all_messages",
       "handoff_context_size": 1,
       "silent_handoff": true,
       "members": [
         {
           "assistant_id": "01JQ0000000000000000000000",
           "role": "entry",
           "alias": "string",
           "pin_mode": "latest",
           "assistant_version_id": "01JQ0000000000000000000000",
           "enabled": true
         }
       ],
       "routes": [
         {
           "id": "01JQ0000000000000000000000",
           "name": "Support Line",
           "trigger": "tool",
           "trigger_value": "string",
           "condition": [],
           "destination_type": "assistant",
           "destination_assistant_id": "01JQ0000000000000000000000",
           "destination_squad_id": "01JQ0000000000000000000000",
           "destination_queue_id": "01JQ0000000000000000000000",
           "destination_expression": "string",
           "context_mode": "all_messages",
           "context_size": 1,
           "extract_variables": [],
           "silent": true,
           "message": "string",
           "priority": 1,
           "enabled": true
         }
       ]
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads/01JQ0000000000000000000000`, {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Support Line",
    "entry_assistant_id": "01JQ0000000000000000000000",
    "handoff_context_mode": "all_messages",
    "handoff_context_size": 1,
    "silent_handoff": true,
    "members": [
      {
        "assistant_id": "01JQ0000000000000000000000",
        "role": "entry",
        "alias": "string",
        "pin_mode": "latest",
        "assistant_version_id": "01JQ0000000000000000000000",
        "enabled": true
      }
    ],
    "routes": [
      {
        "id": "01JQ0000000000000000000000",
        "name": "Support Line",
        "trigger": "tool",
        "trigger_value": "string",
        "condition": [],
        "destination_type": "assistant",
        "destination_assistant_id": "01JQ0000000000000000000000",
        "destination_squad_id": "01JQ0000000000000000000000",
        "destination_queue_id": "01JQ0000000000000000000000",
        "destination_expression": "string",
        "context_mode": "all_messages",
        "context_size": 1,
        "extract_variables": [],
        "silent": true,
        "message": "string",
        "priority": 1,
        "enabled": true
      }
    ]
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Support Line',
    'entry_assistant_id' => '01JQ0000000000000000000000',
    'handoff_context_mode' => 'all_messages',
    'handoff_context_size' => 1,
    'silent_handoff' => true,
    'members' => [
        [
            'assistant_id' => '01JQ0000000000000000000000',
            'role' => 'entry',
            'alias' => 'string',
            'pin_mode' => 'latest',
            'assistant_version_id' => '01JQ0000000000000000000000',
            'enabled' => true,
        ],
    ],
    'routes' => [
        [
            'id' => '01JQ0000000000000000000000',
            'name' => 'Support Line',
            'trigger' => 'tool',
            'trigger_value' => 'string',
            'condition' => [],
            'destination_type' => 'assistant',
            'destination_assistant_id' => '01JQ0000000000000000000000',
            'destination_squad_id' => '01JQ0000000000000000000000',
            'destination_queue_id' => '01JQ0000000000000000000000',
            'destination_expression' => 'string',
            'context_mode' => 'all_messages',
            'context_size' => 1,
            'extract_variables' => [],
            'silent' => true,
            'message' => 'string',
            'priority' => 1,
            'enabled' => true,
        ],
    ],
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.put(
    f"{os.environ['CALLAGENT_API_URL']}/squads/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "name": "Support Line",
      "entry_assistant_id": "01JQ0000000000000000000000",
      "handoff_context_mode": "all_messages",
      "handoff_context_size": 1,
      "silent_handoff": True,
      "members": [
        {
          "assistant_id": "01JQ0000000000000000000000",
          "role": "entry",
          "alias": "string",
          "pin_mode": "latest",
          "assistant_version_id": "01JQ0000000000000000000000",
          "enabled": True
        }
      ],
      "routes": [
        {
          "id": "01JQ0000000000000000000000",
          "name": "Support Line",
          "trigger": "tool",
          "trigger_value": "string",
          "condition": [],
          "destination_type": "assistant",
          "destination_assistant_id": "01JQ0000000000000000000000",
          "destination_squad_id": "01JQ0000000000000000000000",
          "destination_queue_id": "01JQ0000000000000000000000",
          "destination_expression": "string",
          "context_mode": "all_messages",
          "context_size": 1,
          "extract_variables": [],
          "silent": True,
          "message": "string",
          "priority": 1,
          "enabled": True
        }
      ]
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`SquadResource`

Erori

Status	Când apare
`403`	The key lacks squad.write
`404`	No such squad in this organization
`422`	Validation failed, or a referenced assistant/squad is not in this organization

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "id": "01JQ0000000000000000000000",
    "object": "string",
    "name": "Support Line",
    "description": "string",
    "status": "string",
    "is_published": true,
    "version": 1,
    "current_version_id": "01JQ0000000000000000000000",
    "entry_assistant_id": "01JQ0000000000000000000000",
    "handoff_context_mode": "string",
    "handoff_context_size": 1,
    "handoff_extract_variables": {},
    "silent_handoff": true,
    "handoff_message": "string",
    "metadata": {},
    "members": [
      {}
    ],
    "routes": [
      {}
    ],
    "created_at": "2026-01-01T12:00:00+00:00",
    "updated_at": "2026-01-01T12:00:00+00:00"
  }
}

Deletes a squad along with its routing table and membership

DELETE/squads/{squad}

Necesită squad.write.
Acest răspuns nu este împachetat în data.
Body is a bare {"deleted": true, "id": "..."}. Deleting a squad needs only squad.write; there is no separate squad.delete permission.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`squad`	string	da	The squad ID

cURLJavaScriptPHPPython

bash

curl -X DELETE "$CALLAGENT_API_URL/squads/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads/01JQ0000000000000000000000`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.delete(
    f"{os.environ['CALLAGENT_API_URL']}/squads/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	Bare JSON object, not `data`-wrapped

Erori

Status	Când apare
`403`	The key lacks squad.write
`404`	No such squad in this organization

Exemplu de răspuns, generat din schemă:

json

{
  "deleted": true,
  "id": null
}

Validates the squad's routing graph and freezes it into a new version, returning its id and number

POST/squads/{squad}/publish

Necesită squad.write.
Returns only {version_id, version}, not a full version resource. Publishing a squad needs only squad.write, unlike assistants which need assistant.publish.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`squad`	string	da	The squad ID

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/squads/01JQ0000000000000000000000/publish" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads/01JQ0000000000000000000000/publish`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads/01JQ0000000000000000000000/publish');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/squads/01JQ0000000000000000000000/publish",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`201`	`data`-wrapped object

Erori

Status	Când apare
`403`	The key lacks squad.write
`404`	No such squad in this organization
`422`	The squad fails publish-time validation

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "version_id": null,
    "version": 1
  }
}

Dry-runs the routing table against a hypothetical signal and returns the handoff decision it would make

POST/squads/{squad}/resolve-handoff

Necesită squad.read.
Read-only despite being a POST: nothing is persisted. signal is required; messages, variables and from_member_id are optional.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`squad`	string	da	The squad ID

Corpul cererii

Câmp	Tip	Obligatoriu
`signal`	object	da
`signal.tool`	string \| null	—
`signal.intent`	string \| null	—
`variables`	string[] \| null	—
`messages`	string[] \| null	—
`from_member_id`	string \| null	—

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/squads/01JQ0000000000000000000000/resolve-handoff" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "signal": {
         "tool": "string",
         "intent": "string"
       },
       "from_member_id": "01JQ0000000000000000000000"
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads/01JQ0000000000000000000000/resolve-handoff`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "signal": {
      "tool": "string",
      "intent": "string"
    },
    "from_member_id": "01JQ0000000000000000000000"
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads/01JQ0000000000000000000000/resolve-handoff');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'signal' => [
        'tool' => 'string',
        'intent' => 'string',
    ],
    'from_member_id' => '01JQ0000000000000000000000',
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/squads/01JQ0000000000000000000000/resolve-handoff",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "signal": {
        "tool": "string",
        "intent": "string"
      },
      "from_member_id": "01JQ0000000000000000000000"
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Erori

Status	Când apare
`403`	The key lacks squad.read
`404`	No such squad in this organization
`422`	`signal` is missing or is not an object

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "matched": true,
    "route_id": null,
    "destination_type": "string",
    "destination": [
      "string"
    ],
    "context_mode": "string",
    "context": [
      "string"
    ],
    "silent": true,
    "message": null,
    "variables": "string",
    "reason": "string"
  }
}

Returns the routing graph the gateway consumes: squad settings, members and every route in priority order

GET/squads/{squad}/snapshot

Necesită squad.read.
Built live from the current draft, not from a published version, and carries schema_version for gateway compatibility.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`squad`	string	da	The squad ID

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/squads/01JQ0000000000000000000000/snapshot" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads/01JQ0000000000000000000000/snapshot`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads/01JQ0000000000000000000000/snapshot');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/squads/01JQ0000000000000000000000/snapshot",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Erori

Status	Când apare
`403`	The key lacks squad.read
`404`	No such squad in this organization

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "schema_version": 1,
    "squad": {
      "id": null,
      "name": "Support Line",
      "entry_assistant_id": "01JQ0000000000000000000000",
      "handoff_context_mode": "string",
      "handoff_context_size": 1,
      "silent_handoff": true,
      "handoff_message": "string",
      "extract_variables": {}
    },
    "members": [
      {}
    ],
    "routes": [
      {}
    ]
  }
}

Runs the publish-time routing checks without publishing and returns the error list

GET/squads/{squad}/validate

Necesită squad.read.
A failing squad still answers 200 with valid:false. Catches missing entry assistants, self-handoffs and routes to non-members.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`squad`	string	da	The squad ID

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/squads/01JQ0000000000000000000000/validate" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/squads/01JQ0000000000000000000000/validate`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/squads/01JQ0000000000000000000000/validate');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/squads/01JQ0000000000000000000000/validate",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Erori

Status	Când apare
`403`	The key lacks squad.read
`404`	No such squad in this organization

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "valid": true,
    "errors": [
      "string"
    ]
  }
}

Squad-uri ​

Endpoint-uri ​

Lists the organization's squads with their members and routing table loaded ​

Creates a draft squad together with its members and routing table in one transaction ​

Returns one squad with its members and routing table ​

Updates a squad and, when supplied, replaces its member list and routing table wholesale ​

Deletes a squad along with its routing table and membership ​

Validates the squad's routing graph and freezes it into a new version, returning its id and number ​

Dry-runs the routing table against a hypothetical signal and returns the handoff decision it would make ​

Returns the routing graph the gateway consumes: squad settings, members and every route in priority order ​

Runs the publish-time routing checks without publishing and returns the error list ​

Squad-uri

Endpoint-uri

Lists the organization's squads with their members and routing table loaded

Creates a draft squad together with its members and routing table in one transaction

Returns one squad with its members and routing table

Updates a squad and, when supplied, replaces its member list and routing table wholesale

Deletes a squad along with its routing table and membership

Validates the squad's routing graph and freezes it into a new version, returning its id and number

Dry-runs the routing table against a hypothetical signal and returns the handoff decision it would make

Returns the routing graph the gateway consumes: squad settings, members and every route in priority order

Runs the publish-time routing checks without publishing and returns the error list