> ## 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 de la Herramienta

> Devuelve el historial de cambios de una herramienta específica.

## Endpoint

`GET https://gateway.orkeia.ai/tools/{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 de la herramienta. | TOOL\_123456 |

## Ejemplo (cURL)

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

## Respuestas

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": [
    {
      "id": "EVT_2",
      "toolId": "TOOL_123456",
      "action": "updated",
      "timestamp": "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

| Campo     | Tipo   | Descripción                                     |
| --------- | ------ | ----------------------------------------------- |
| id        | string | Identificador único del evento de historial.    |
| toolId    | string | ID de la herramienta relacionada con el evento. |
| action    | string | Acción realizada (ej.: `created`, `updated`).   |
| timestamp | string | Fecha/hora del evento en formato ISO 8601.      |