---
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"
}
```