---
title: "Create an additional image for media"
method: POST
path: "/v2/sites/{site_id}/media/{media_id}/images/"
tags: ["image"]
---

# Create an additional image for media

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

## Request

- Base URL: `https://api.jwplayer.com`
- URL: `https://api.jwplayer.com/v2/sites/{site_id}/media/{media_id}/images/`
- Auth: API key in header `Authorization`

Before you can upload a new image, you need to create a new image first. This endpoint allows you to create a new image resource. In the response, you'll receive `upload_link` or `upload_id` and `upload_token` depending on the `upload.method` provided.
**NOTE:** If the site already has 40 unique labels, a request to create an image with a new label will be rejected.

## Path parameters

- `site_id` string, required: Unique identifier for a resource
- `media_id` string, required: Unique identifier for a resource

## Request body

- object
  - `metadata` object
    - `label` string, string: Label associated with the image There can be a maximum of 40 labels per site. A label can be associated with multiple images. This value can be used to access the image via the Delivery API.
  - `upload` object: Method and information required to upload and process the image
    - `method` 'direct' | 'fetch' | 'multipart': Upload method **Possible values**: - `direct`: Best for uploading image files on a local machine - `fetch`: Best for uploading images files hosted on another platform - `multipart`: Best for uploading image files on a local machine that are uploaded in chunks
    - `download_url` unknown

## Response `201`

Request to add image successful

- ImageCreateResourceRead
  - `schema` string
  - `id` string: Unique identifier for a resource
  - `created` string: Date and time at which the resource was created
  - `last_modified` string: Date and time at which the resource was most recently modified
  - `type` string: Name of the type of resource.
  - `relationships` object: Ancilliary resources associated to the primary resource being read
  - `metadata` object
    - `label` string, string: Label associated with the image There can be a maximum of 40 labels per site. A label can be associated with multiple images. This value can be used to access the image via the Delivery API.
  - `image_data` object: Object containing information about the image
    - `width` integer: Width in pixels of the original image
    - `height` integer: Height in pixels of the original image
    - `mime_type` 'image/jpeg' | 'image/png' | 'image/webp': MIME type of the original image
  - `upload_link` string: URL to be used for uploads This is returned only when `upload.method` is `direct`.

## Other responses

- `default`: API Error response

---

[API](https://skmtc.dev/jwplayer/apis/management-api-v2.md) - [All operations](https://skmtc.dev/jwplayer/apis/management-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jwplayer/apis/management-api-v2/revisions/9fad6bd5872e?raw)