---
search:
  tags:
    - الأدوات
    - POST
seo:
  description: >-
    استدع أداة يتضمن واصف استكشافها confirmation: "none". يشمل ذلك قراءة
    البيانات ومتابعة رفع مصرح به مسبقا. أرسل {input: {...}} وفق المخطط المطابق
    لاسم الأداة في…
sidebar:
  label: استدعاء أداة دون تأكيد
  badge: POST
title: استدعاء أداة دون تأكيد
type: openapi-operation
---
استدع أداة يتضمن واصف استكشافها confirmation: "none". يشمل ذلك قراءة البيانات ومتابعة رفع مصرح به مسبقا. أرسل {input: {...}} وفق المخطط المطابق لاسم الأداة في المسار. يقتصر حجم طلبات JSON على 65,536 بايت. قد تتضمن استجابة 200 القيمة ok:false.

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

**محتوى الطلب** (`application/json`, مطلوب)

- `input` (object, مطلوب)

مثال لمحتوى الطلب:

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

**الاستجابات**

- `200` — نتيجة الأداة؛ راجع ok وerror.
- `400` — الطلب غير صالح. معاملات الاستعلام غير مقبولة. قد ترد أخطاء التحقق الخاصة بالأداة ضمن استجابة خطأ للأداة.
- `401` — بيانات اعتماد Bearer غير موجودة أو غير صالحة أو منتهية الصلاحية.
- `403` — بيانات الاعتماد لا تتضمن الصلاحيات المطلوبة.
- `404` — واجهة API المخصصة للبرامج أو الأداة المطلوبة غير متاحة.
- `413` — يتجاوز الطلب الحد الأقصى للبايتات.
- `429` — جرى تجاوز حد معدل الطلبات. يمكن إعادة المحاولة بعد هذا الخطأ.
- `503` — واجهة API أو خدمة التنفيذ التي تعتمد عليها غير متاحة.

مثال للاستجابة, 200:

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