---
title: "Changes to Create a media"
method: POST
path: "/v2/sites/{site_id}/media/"
---

# Changes to Create a media

`POST /v2/sites/{site_id}/media/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `9fad6bd5872e`: 1 breaking, 15 warning, 6 info

## Changes

- **2026-11-03** `9fad6bd5872e`: 1 breaking, 15 warning, 6 info
  - the `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata` response's property type changed from `object` to no type for status `201`
  - removed the request property `metadata/allOf[#/components/schemas/MediaResourceMetadata]/content_type`
  - removed the request property `metadata/allOf[#/components/schemas/MediaResourceMetadata]/duration`
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/author` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/category` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/content_type` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/custom_params` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/description` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/drm` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/duration` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/language` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/permalink` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/publish_end_date` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/publish_start_date` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/tags` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata/title` from the response with the `201` status
  - added the new optional request property `metadata/allOf[#/components/schemas/MediaResourceCreateOnlyMetadata]/duration`
  - added the new optional request property `transcoding_config_id`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/md5` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/source_url` to the response with the `201` status
  - added `#/components/schemas/MediaResourceMetadata, subschema #2` to the `allOf[#/components/schemas/MediaResourceRead]/allOf[subschema #2]/metadata` response property `allOf` list for the response status `201`

---

[Operation](https://skmtc.dev/jwplayer/apis/management-api-v2/docs/v2/sites/:site_id/media/post.md) - [API](https://skmtc.dev/jwplayer/apis/management-api-v2.md) - [Page](https://skmtc.dev/jwplayer/apis/management-api-v2/changes/v2/sites/:site_id/media/post)