# AddObjectImages

Adds training images to an object.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
`database` | The name of the database that contains the object. | Yes
`identifier` | The identifier of the object that you want to add training images to. | Yes
`imagedata` | The training images to add. Files must be uploaded as multipart/form-data. For more information about sending data to Media Server, refer to the Media Server Administration Guide. | Set this or `imagepath`
`imagelabels` | A comma-separated list of labels to identify the images that you are adding (maximum 254 bytes for each label). Every image added to the same object must have a unique label, so the number of labels must match the number of images provided using either `imagedata` or `imagepath`. If you do not set this parameter, Media Server generates labels automatically. | No
`imagepath` | A comma-separated list of paths to the training images to add. The paths must be absolute, or relative to the Media Server executable file. | Set this or `imagedata`

## Example

The following example adds training images to an object by specifying the paths of the images using the `imagepath` parameter:

    /action=AddObjectImages&database=CompanyLogos
                           &identifier=6d8e53fd92e601a4b8948e1b9397e381
                           &imagepath=object1.jpg
                           &imagelabels=standard_logo

Alternatively, you can add training images by sending the image data, for example:

    curl http://localhost:14000 -F action=AddObjectImages
                                -F database=CompanyLogos
                                -F identifier=6d8e53fd92e601a4b8948e1b9397e381
                                -F imagedata=@object1.jpg
                                -F imagelabels=standard_logo

## Response

The response returns the labels assigned to the training images:

    <autnresponse>
      <action>ADDOBJECTIMAGES</action>
      <response>SUCCESS</response>
      <responsedata>
        <images>
          <image>
            <index>1</index>
            <label>standard_logo</label>
          </image>
        </images>
      </responsedata>
    </autnresponse>

## See Also

After adding training images for an object, you can train Media Server to recognize the object by running the action BuildObject.

_FT_HTML5_bannerTitle.htm