Management API Documentation

Create image

Description

Create a new image

Important: this method uses the “multipart/form-data” format, because of file upload efficiency.

Consider reading our recommendations before populating your collection, it might help to improve the recognition latter on.

Url

Parameters optional

  • item: resource uri like /v0/item/UUID/
  • file: file with the new reference image

Example

Create an image (using local file back_cover.jpg) in the item whose UUID is 4fe672886ec142f6ab6d72d54acf046f

Request

HTTP Status code: 201 Created

Response

Errors

HTTP Status code: 400 Bad Request

POST data is not in multipart/form-data

Item missing or not found

Invalid image

Image too small

HTTP Status code: 403 Forbidden

Image limit reached

AR Item already has an image