---
search:
  tags:
    - Herramientas
    - POST
seo:
  description: >-
    Llama a una herramienta de solo lectura. Envía {input: {...}} según el
    esquema de la herramienta indicada en la ruta. Las solicitudes JSON tienen
    un límite de…
sidebar:
  label: Llamar a una herramienta de solo lectura
  badge: POST
title: Llamar a una herramienta de solo lectura
type: openapi-operation
---
Llama a una herramienta de solo lectura. Envía {input: {...}} según el esquema de la herramienta indicada en la ruta. Las solicitudes JSON tienen un límite de 65536 bytes. Una respuesta 200 puede contener ok:false.

`POST /api/v1/tools/{tool}/call`

**Cuerpo de la solicitud** (`application/json`, obligatorio)

- `input` (object, obligatorio)

Ejemplo del cuerpo de la solicitud:

```json
{
  "input": {
    "property1": "string",
    "property2": "string"
  }
}
```

**Respuestas**

- `200` — Resultado de la herramienta; comprueba ok y error.
- `400` — Solicitud no válida. No se aceptan parámetros de consulta. Los fallos de validación pueden usar el formato de error de la herramienta.
- `401` — Credencial bearer ausente, no válida o caducada.
- `403` — Las credenciales no tienen los permisos necesarios.
- `404` — La API o la herramienta solicitada no está disponible.
- `413` — La solicitud supera el límite de bytes.
- `429` — Se ha superado el límite de solicitudes. Se puede reintentar.
- `503` — La API o el servicio que ejecuta la operación no está disponible.

Ejemplo de respuesta, 200:

```json
{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}
```