# Create embed asset upload URL
`POST https://octopus.livepush.io/streams/{stream_id}/embed/assets/upload_url`
Returns a signed URL for uploading an embed asset — a cover image, brand icon or caption image. Upload the bytes to the returned URL, then attach the asset with the matching setting endpoint.

Requires a token with write access to the stream (`CanWriteStreams`).
- **Tag:** Stream Embed
- **Operation ID:** `postStreamEmbedAssetsUploadUrl`
- **Authentication:** Bearer token required
- **Docs:** https://developers.livepush.io/stream-embed/create-embed-asset-upload-url/

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `stream_id` | string | yes | Unique identifier of the stream. |


### Request body

`application/json` (required)

- `assetType` (string) **required** — Which embed slot the asset is destined for.
- `type` (string) **required** — MIME type of the file.
- `size` (integer) **required** — File size in bytes.
- `originalFilename` (string) **required**


```json
{
  "assetType": "cover_img",
  "type": "image/jpeg",
  "size": 184320,
  "originalFilename": "cover.jpg"
}
```


### Example request

```bash
curl -X POST 'https://octopus.livepush.io/streams/st_xxxxxxxxxxxxx/embed/assets/upload_url' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "assetType": "cover_img",
    "type": "image/jpeg",
    "size": 184320,
    "originalFilename": "cover.jpg"
  }'
```


### Responses


#### 200 — Setting applied.

- `success` (boolean)


```json
{
  "success": true
}
```


#### 400 — Response


#### 401 — Response