# willo_put_object

> Copy ONE file into a PRIVATE bucket on the LIVE backend and get its size and SHA-256.

Generated from Willo's code at each release.

Source: https://www.willo.ai/docs/reference/mcp-tools/willo-put-object

**Copy a file into private storage.** Source is exactly one of `repo_path` (a file in the site's repo), `document_id` (a generated PDF from willo_documents). `bucket` defaults to Willo's private bucket; a named bucket must exist and be private. Never overwrites. Runs without a card.

## Access

- **Token**: read + act, and editor access or higher on the business.
- **Approval**: Only when Willo's chat would stop for the same action. The description says when; otherwise the call runs at once.
- **Metered**: counts toward a per-business, per-minute limit for this kind of call. See [Limits](https://www.willo.ai/docs/reference/limits).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `bucket` | string | no | A private bucket (willo_buckets). Omit for Willo's private bucket. |
| `path` | string | no | Where to store it, e.g. `reports/q3.pdf`. Omit to use the source's file name. |
| `repo_path` | string | no | Source: a repo-relative file path. |
| `document_id` | integer ≥ 1 | no | Source: a generated PDF's document id. |

## Related

- [All MCP tools](https://www.willo.ai/docs/reference/mcp-tools)
- [Error codes](https://www.willo.ai/docs/reference/errors)
- [Draft and live](https://www.willo.ai/docs/ai-agents/draft-and-live)
