---
search:
  tags:
    - ツール
    - POST
seo:
  description: >-
    {input: {...}} で変更を準備します。この段階では投稿を承認も公開もしません。準備が成功すると confirmationCapability
    と expiresAt を返します。ツールエラーでも…
sidebar:
  label: 変更を準備
  badge: POST
title: 変更を準備
type: openapi-operation
---
{input: {...}} で変更を準備します。この段階では投稿を承認も公開もしません。準備が成功すると confirmationCapability と expiresAt を返します。ツールエラーでも HTTP 200 を返す場合があります。JSON リクエストの上限は 65536 バイトです。

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