[comment]: # ({991d071b-991d071b})
# history.clear

[comment]: # ({/991d071b-991d071b})

[comment]: # ({7c7c67ac-3bf9d0da})
### Descripción

`object history.clear(array itemids)`

Este método permite borrar el historial de una métrica.

::: noteclassic
Este método solo está disponible para los tipos de usuario *Administrador* y *Superadministrador*.
Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario.
Ver [Roles de
usuario](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::

[comment]: # ({/7c7c67ac-3bf9d0da})

[comment]: # ({f449cc26-f449cc26})
### Parámetros

`(matriz)` ID de los elementos que se van a borrar.

[comment]: # ({/f449cc26-f449cc26})

[comment]: # ({a59d9134-a59d9134})
### Valores de retorno

`(objeto)` Devuelve un objeto que contiene los ID de los elementos borrados
bajo la propiedad "itemids".

[comment]: # ({/a59d9134-a59d9134})

[comment]: # ({b41637d2-b41637d2})
### Ejemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({c73cef81-e482fed3})
#### Borrar historial

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "history.clear",
    "params": [
        "10325",
        "13205"
    ],
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "10325",
            "13205"
        ]
    },
    "id": 1
}
```

[comment]: # ({/c73cef81-e482fed3})

[comment]: # ({e7aa34e8-e7aa34e8})
### Fuente

CHistory::clear() en *ui/include/classes/api/services/CHistory.php*.

[comment]: # ({/e7aa34e8-e7aa34e8})