> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Box

> Secure file storage, sharing, collaboration, and governance via your connected account.

Use Box when your workflow needs secure file and folder management, sharing, or review. You can also use it to search content, add comments, and route documents for signature.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Box account to use for this step. |
| Action | Yes | The Box action to perform (for example Get file information, Update file, Download file, Copy file). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Box in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get file information** | Retrieves the details for a file. |
| **Update file** | Updates a file's details or properties. |
| **Download file** | Downloads the contents of a file in binary format. |
| **Copy file** | Creates a copy of a file in another folder. |
| **Get folder information** | Retrieves details for a folder and its first items. |
| **Create folder** | Creates a new empty folder. |
| **Update folder** | Updates a folder's details or settings. |
| **List folder items** | Lists the items in a folder. |
| **List file comments** | Lists all comments on a file. |
| **Create comment** | Adds a comment to a file or replies to a comment. |
| **Get comment** | Retrieves the content and metadata for a comment. |
| **List file collaborations** | Lists active and pending collaborations on a file. |
| **List folder collaborations** | Lists active and pending collaborations on a folder. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Box response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Box if you have not already done that.
2. Add a **Box** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get file information** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Review a file and comment

1. Search for content
2. Get file information
3. Create comment

### Share a folder with a teammate

1. Get folder information
2. Create collaboration
3. Add shared link

### Send a document for signature

1. Get file information
2. Create Box Sign request
3. Get Box Sign request

## Notes

* This step depends on a connected Box integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Box tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Box as an Agent Tool

You can also add Box as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Box**. In the tool settings panel, choose the connected account the agent should use. The agent calls Box actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.