Create a default image

Request

To create a default image in IHS, send a POST request to:

Headers

• Content-Type: multipart/form-data

Mandatory arguments

• metadata (in body) – a JSON object that contains:

  • name – must be unique

  • height (in pixels)

  • width (in pixels)

  • genre (array with one or more values) – optional

• imageFile – the actual image file, attached to the request

IHS places the uploaded image in an S3 bucket. If you specify one or more genres, IHS will use them when trying to find a matching image for content.

Example

This is an example of the metadata part of the request body:

{  
   "name":"p183996_i_h6_ab.jpg",
   "height":1080,
   "width":960,
   "genre":[  
      "action",
      "comedy"
   ]
}

Response

If the request is successful, a 202 response is returned with a body that contains the image URI:

{
    "uri": "/persons/25?requestId=5c62d742d69b040001e54a71"
}

A bad request returns a 400 response.

See also

For full details of this API, see Create default image metadata.