---
title: creative_upload_url_create
description: Create a signed file upload URL for the connected workspace.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_upload_url_create
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_upload_url_create.md
contentType: reference
---

# creative_upload_url_create

Create a signed file upload URL for the connected workspace.

**Operation** Write. Requires read-and-write OAuth consent.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `body` | object | Yes | File metadata. |
| `body.content_type` | string | Yes | File MIME type, for example `image/png`. |
| `body.size_bytes` | integer | Yes | Exact size in bytes, from 1 to 2,147,483,648. |
| `body.filename` | string | No | Original filename, up to 255 characters. |
| `idempotency_key` | string | Yes | Key for this upload request. |
| `approval_receipt` | string | No | Receipt from the plan. Supply it after confirmation. |

After confirmation, resubmit the call with its `approval_receipt`. Within 15 minutes, send the raw file bytes in a client-side `PUT` to `data.upload_url` with `data.upload_headers` unchanged. The signed URL authorizes the PUT. Keep the Orchestor API key out of that request.

After the PUT succeeds, pass `data.public_url` in `body.image_urls` to `creative_generate_image` with a model that accepts reference images. The read URL is valid for seven days from issuance.

## Sample prompt

```text
Upload my local product.png and use it as a reference for a new product photo.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
