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

# Tools version post

## Endpoint

`POST https://gateway.orkeia.ai/tools/{id}/version-control`

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

## Parámetros de Ruta

| Nombre | Tipo   | Obligatorio | Descripción                            | Ejemplo      |
| ------ | ------ | ----------- | -------------------------------------- | ------------ |
| id     | string | Sí          | Identificador único de la herramienta. | TOOL\_123456 |

## Cuerpo de la Solicitud (JSON)

> **Atención:** este endpoint **no crea** una nueva versión. **Revierte** a una versión existente, identificada por `versionControl`.

```json theme={null}
{
  "versionControl": "v1.0.2"
}
```

## Ejemplo (cURL)

```bash theme={null}
curl -X POST "https://gateway.orkeia.ai/tools/TOOL_123456/version-control"   -H "authorization:  <tu_token>"   -H "Content-Type: application/json"   -d '{ "versionControl": "v1.0.2" }'
```

## Respuestas

### Response - Éxito

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

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

## Observaciones

* Las versiones se generan automáticamente cuando la herramienta es **creada** o **actualizada**.
* Usa este endpoint para **revertir** a un snapshot anterior.