---
title: "OutputFilesServerToolItem"
---

An openrouter:files server tool output item


## Fields

| Field                                                                                      | Type                                                                                       | Required                                                                                   | Description                                                                                | Example                                                                                    |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| `error`                                                                                    | *Optional[str]*                                                                            | :heavy_minus_sign:                                                                         | Error message when the file operation failed.                                              |                                                                                            |
| `file_id`                                                                                  | *Optional[str]*                                                                            | :heavy_minus_sign:                                                                         | The target file id supplied in the tool-call arguments.                                    |                                                                                            |
| `filename`                                                                                 | *Optional[str]*                                                                            | :heavy_minus_sign:                                                                         | The target filename supplied in the tool-call arguments.                                   |                                                                                            |
| `id`                                                                                       | *Optional[str]*                                                                            | :heavy_minus_sign:                                                                         | N/A                                                                                        |                                                                                            |
| `operation`                                                                                | *Optional[str]*                                                                            | :heavy_minus_sign:                                                                         | The file operation performed (list, read, write, or edit).                                 |                                                                                            |
| `result`                                                                                   | *Optional[str]*                                                                            | :heavy_minus_sign:                                                                         | JSON-serialized result of the file operation.                                              |                                                                                            |
| `status`                                                                                   | [components.ToolCallStatus](../components/toolcallstatus.mdx)                               | :heavy_check_mark:                                                                         | N/A                                                                                        | completed                                                                                  |
| `type`                                                                                     | [components.OutputFilesServerToolItemType](../components/outputfilesservertoolitemtype.mdx) | :heavy_check_mark:                                                                         | N/A                                                                                        |                                                                                            |