---
title: "POST /api/media/{mediaReferenceId}/replace"
method: POST
path: "/api/media/{mediaReferenceId}/replace"
tags: ["TenantMedia"]
---

# POST /api/media/{mediaReferenceId}/replace

`POST /api/media/{mediaReferenceId}/replace`

## Request

- Base URL: `https://api.wearelearning.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wearelearning.io/api/media/{mediaReferenceId}/replace`
- Auth: OAuth 2
  - Implicit: `https://login.wearelearning.io/authorize?audience=https://api.wearelearning.io`

## Path parameters

- `mediaReferenceId` string, uuid, required: A valid GUID

## Request body `multipart/form-data`

- object
  - `file` string, binary

## Response `200`

OK

- MediaReferenceDto
  - `id` string, required
  - `fileName` string, required
  - `extension` string, required
  - `contentType` string, required
  - `url` string, required
  - `publicUrl` string, required
  - `thumbnailUrl` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `metadata` MetadataDto, required
    - `type` 'Image' | 'ImageVersion' | 'Video' | 'Audio' | 'Document', required
    - `size` integer, nullable
  - `folderId` string, uuid, nullable: A valid GUID

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/wearelearning/apis/we-are-learning-api.md) - [All operations](https://skmtc.dev/wearelearning/apis/we-are-learning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wearelearning/apis/we-are-learning-api/revisions/e2ca5265db77?raw)