---
title: "ApplyPatchCallItem"
---

A tool call emitted by the model requesting a V4A patch operation. The client applies the patch and echoes an `apply_patch_call_output` on the next turn.


## Fields

| Field                                                                                                                             | Type                                                                                                                              | Required                                                                                                                          | Description                                                                                                                       | Example                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `call_id`                                                                                                                         | *str*                                                                                                                             | :heavy_check_mark:                                                                                                                | N/A                                                                                                                               |                                                                                                                                   |
| `id`                                                                                                                              | *OptionalNullable[str]*                                                                                                           | :heavy_minus_sign:                                                                                                                | N/A                                                                                                                               |                                                                                                                                   |
| `operation`                                                                                                                       | [components.ApplyPatchCallOperation](../components/applypatchcalloperation.mdx)                                                    | :heavy_check_mark:                                                                                                                | The patch operation requested by an `apply_patch_call`. `create_file` and `update_file` carry a V4A diff; `delete_file` omits it. | \{<br/>"diff": "@@ function main() \{\n+  console.log(\"hi\");\n }",<br/>"path": "/src/main.ts",<br/>"type": "update_file"<br/>}    |
| `status`                                                                                                                          | [components.ApplyPatchCallStatus](../components/applypatchcallstatus.mdx)                                                          | :heavy_check_mark:                                                                                                                | Lifecycle state of an `apply_patch_call` output item.                                                                             | completed                                                                                                                         |
| `type`                                                                                                                            | [components.ApplyPatchCallItemType](../components/applypatchcallitemtype.mdx)                                                      | :heavy_check_mark:                                                                                                                | N/A                                                                                                                               |                                                                                                                                   |