---
title: "Create new media item"
method: POST
path: "/media-item"
tags: ["Media"]
---

# Create new media item

`POST /media-item`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/media-item`
- Auth: `appAuth` (a scheme the document does not define)

## Headers

- `AgencyRef` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `request` PostMediaItemRequest, required
    - `linkedType` 'Property'
    - `linkedId` integer
    - `mediaType` 'Photo' | 'Floorplan' | 'VirtualTour' | 'File' | 'Document' | 'Brochure' | 'EPC' | 'WebLink', nullable
    - `fileToUpload` string, binary, nullable
    - `filename` string, nullable
    - `caption` string, nullable: Optional caption for the media item. When omitted or blank, the Filename is used as the caption.

## Response `200`

The id of the new media

- PostMediaItemResponse
  - `mediaId` integer

## Other responses

- `400`: When the request does not contain the expected information
- `401`: When access has not been granted
- `404`: The entity is not found

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)