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