> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkeia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear Squad

> Crea un nuevo squad en el ambiente.

## Endpoint

`POST https://gateway.orkeia.ai/squads`

**Autenticación**\
Requiere el encabezado `authorization:  <tu_token>`.

## Cuerpo de la Solicitud (JSON)

> El servicio espera un **wrapper** con la propiedad `squad`.

```json theme={null}
{
  "squad": {
    "name": "Equipo Alpha",
    "tasks": [
      {
        "id": "TASK_INGEST",
        "agent": "AGENT_INGEST",
        "name": "Ingestión de Datos",
        "objective": "Colectar y normalizar datos de origen externo",
        "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 principales de `Squad`**
>
> | Campo         | Tipo                               | Obligatorio | Descripción                                          |
> | ------------- | ---------------------------------- | ----------- | ---------------------------------------------------- |
> | name          | string                             | Sí          | Nombre amigable del squad.                           |
> | tasks         | `Task[]`                           | Sí          | Lista de tareas orquestadas por el squad.            |
> | order         | `"sequential"` \| `"hierarchical"` | Sí          | Estrategia de ejecución de las tareas.               |
> | enabled       | boolean                            | Sí          | Activa/desactiva el squad.                           |
> | do\_plan      | boolean                            | Sí          | Si hay etapa de planificación antes de la ejecución. |
> | sectors       | string\[]                          | Sí          | Sectores con permiso para usar el squad.             |
> | publisher     | string                             | Sí          | Publicador/organización responsable.                 |
> | planningAgent | `{ id: string, coordinates? }`     | No          | (Opcional) Agente dedicado a la planificación.       |
> | supervisor    | `{ id: string, coordinates? }`     | No          | (Opcional) Agente supervisor/validador.              |

## Ejemplo (cURL)

```bash theme={null}
curl -X POST "https://gateway.orkeia.ai/squads"   -H "authorization:  <tu_token>"   -H "Content-Type: application/json"   -d '{
    "squad": {
      "name": "Equipo Alpha",
      "tasks": [
        {
          "id": "TASK_INGEST",
          "agent": "AGENT_INGEST",
          "name": "Ingestión de Datos",
          "objective": "Colectar y normalizar datos de origen externo",
          "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" }
    }
  }'
```

## Respuestas

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": { "id": "SQUAD_123456" }
}
```

### 500 — Error del Servidor

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Error del Cliente

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```