> ## 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.

# Historial del Squad

> Devuelve el historial de cambios de un squad específico.

## Endpoint

`GET https://gateway.orkeia.ai/squads/{id}/history`

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

## Parámetros de Camino

| Nombre | Tipo   | Obligatorio | Descripción                    | Ejemplo     |
| ------ | ------ | ----------- | ------------------------------ | ----------- |
| id     | string | Sí          | Identificador único del squad. | SQUAD\_1234 |

## Ejemplo (cURL)

```bash theme={null}
curl -X GET "https://gateway.orkeia.ai/squads/SQUAD_1234/history" \
  -H "authorization:  <tu_token>"
```

## Respuestas

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": [
    {
      "id": "hist_002",
      "squadId": "SQUAD_1234",
      "action": "updated squad",
      "type": "neutral",
      "date": "2024-07-01T13:00:00Z"
    }
  ]
}
```

### 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
}
```

## Campos del Historial

| Nombre  | Tipo   | Descripción                                                           |
| ------- | ------ | --------------------------------------------------------------------- |
| id      | string | Identificador único del evento de historial.                          |
| squadId | string | Identificador del squad asociado al evento.                           |
| action  | string | Acción registrada (ej.: created squad, updated squad, deleted squad). |
| type    | string | Clasificación del evento (`success`, `fail`, `neutral`).              |
| date    | Date   | Fecha y hora del cambio.                                              |