---
search:
  tags:
    - Mga tool
    - POST
seo:
  description: >-
    Tumawag ng read-only na tool. Ipadala ang {input: {...}} ayon sa schema ng
    tool na nasa path. Hanggang 65536 bytes lang ang JSON request. Maaaring may…
sidebar:
  label: Tumawag ng read-only na tool
  badge: POST
title: Tumawag ng read-only na tool
type: openapi-operation
---
Tumawag ng read-only na tool. Ipadala ang {input: {...}} ayon sa schema ng tool na nasa path. Hanggang 65536 bytes lang ang JSON request. Maaaring may ok:false ang response na 200.

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

**Nilalaman ng request** (`application/json`, kailangan)

- `input` (object, kailangan)

Halimbawa ng nilalaman ng request:

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

**Mga tugon**

- `200` — Resulta ng tool; tingnan ang ok at error.
- `400` — Hindi valid ang request. Hindi tinatanggap ang query parameters. Maaaring gumamit ng tool error format ang mga validation failure.
- `401` — Wala, hindi valid, o expired ang bearer credentials.
- `403` — Kulang ang kinakailangang permissions ng credentials.
- `404` — Hindi available ang API o ang hiniling na tool.
- `413` — Lumampas sa byte limit ang request.
- `429` — Lumampas sa request limit. Maaaring subukan ulit.
- `503` — Hindi available ang API o ang serbisyong nagpapatakbo ng operasyon.

Halimbawa ng tugon, 200:

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