---
search:
  tags:
    - الأدوات
    - POST
seo:
  description: >-
    حضر عملية تعديل باستخدام {input: {...}}. لا يمنح التحضير موافقة على النشر
    ولا ينفذه. عند نجاح التحضير، تعاد confirmationCapability وexpiresAt؛ وقد
    تعاد…
sidebar:
  label: تحضير عملية تعديل
  badge: POST
title: تحضير عملية تعديل
type: openapi-operation
---
حضر عملية تعديل باستخدام {input: {...}}. لا يمنح التحضير موافقة على النشر ولا ينفذه. عند نجاح التحضير، تعاد confirmationCapability وexpiresAt؛ وقد تعاد استجابة إخفاق للأداة برمز HTTP 200 أيضا. يقتصر حجم طلبات JSON على 65,536 بايت.

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

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

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

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

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

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

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

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

```json
{
  "confirmationCapability": "stringstringstringstringstringst",
  "expiresAt": "2019-08-24T14:15:22Z",
  "inputDigest": "string",
  "status": "confirmation_required",
  "summary": "string",
  "toolName": "adAuditQuote"
}
```