Pular para o conteúdo principal
POST
/
squads

​
Endpoint

POST https://gateway.orkeia.ai/squads Autenticação
Requer cabeçalho authorization: <seu_token>.

​
Corpo da Requisição (JSON)

O serviço espera um wrapper com a propriedade squad. 
{
  "squad": {
    "name": "Equipe Alpha",
    "tasks": [
      {
        "id": "TASK_INGEST",
        "agent": "AGENT_INGEST",
        "name": "Ingestão de Dados",
        "objective": "Coletar e normalizar dados de origem externa",
        "dependsOn": [],
        "coordinates": { "x": 80, "y": 40, "width": 320, "height": 160 }
      }
    ],
    "order": "sequential",
    "enabled": true,
    "do_plan": false,
    "sectors": ["engineering"],
    "publisher": "Orkeia",
    "planningAgent": { "id": "AGENT_PLANNER" },
    "supervisor": { "id": "AGENT_SUPERVISOR" }
  }
}
Campos principais do Squad
CampoTipoObrigatórioDescrição
namestringSimNome amigável do squad.
tasksTask[]SimLista de tarefas orquestradas pelo squad.
order"sequential" | "hierarchical"SimEstratégia de execução das tarefas.
enabledbooleanSimAtiva/desativa o squad.
do_planbooleanSimSe há etapa de planejamento antes da execução.
sectorsstring[]SimSetores com permissão para usar o squad.
publisherstringSimPublicador/organização responsável.
planningAgent{ id: string, coordinates? }Não(Opcional) Agente dedicado ao planejamento.
supervisor{ id: string, coordinates? }Não(Opcional) Agente supervisor/validador.

​
Exemplo (cURL)

curl -X POST "https://gateway.orkeia.ai/squads"   -H "authorization:  <seu_token>"   -H "Content-Type: application/json"   -d '{
    "squad": {
      "name": "Equipe Alpha",
      "tasks": [
        {
          "id": "TASK_INGEST",
          "agent": "AGENT_INGEST",
          "name": "Ingestão de Dados",
          "objective": "Coletar e normalizar dados de origem externa",
          "dependsOn": [],
          "coordinates": { "x": 80, "y": 40, "width": 320, "height": 160 }
        }
      ],
      "order": "sequential",
      "enabled": true,
      "do_plan": false,
      "sectors": ["engineering"],
      "publisher": "Orkeia",
      "planningAgent": { "id": "AGENT_PLANNER" },
      "supervisor": { "id": "AGENT_SUPERVISOR" }
    }
  }'

​
Respostas

​
Response - Success

response
{
  "status": "OK",
  "data": { "id": "SQUAD_123456" }
}

​
500 — Server Error

{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}

​
400 — Client Error

{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}