# Get a signed upload URL

`POST /v1/sandboxes/{sandbox}/files/upload-url`

**In this build:** Uses a stand-in for an external service. The URL and expiry are real. Object-store signing needs a deployed edge.

**Scope:** `file.write`

**CLI:** `harebox file url --upload`

## Request: `SignedUrlRequest`

| Field | Type | Notes |
|---|---|---|
| `path` (required) | `string` |  |
| `expires_seconds` | `integer` |  |

## Response: 200

`SignedUrl`

| Field | Type | Notes |
|---|---|---|
| `url` (required) | `string` |  |
| `expires_at` (required) | `string` |  |

Errors follow [one format](../errors.html).