# NewObject

Inserts a new, empty, object into a database of objects.

NOTE: After adding a new object, you must add images of the object using the action AddObjectImages. You can also set training attributes using the action SetObjectTrainingOption. After adding images, train Media Server to recognize the object using the action BuildObject.

Type: synchronous

Parameter | Description | Required
--- | --- | ---
`database` | The name of the database to add the object to. The database must already exist. | Yes
`identifier` | A unique identifier for the object (maximum 254 bytes). If you do not set this parameter, Media Server generates an identifier automatically. | No

## Example

The following example adds an object to the `CompanyLogos` database:

    /action=NewObject&database=CompanyLogos

You can use the name of the object as the identifier. All identifiers must be unique within the database:

    /action=NewObject&database=CompanyLogos&identifier=HewlettPackard

## Response

The action returns the identifier assigned to the object:

    <autnresponse>
      <action>NEWOBJECT</action>
      <response>SUCCESS</response>
      <responsedata>
        <identifier>6d8e53fd92e601a4b8948e1b9397e381</identifier>
      </responsedata>
    </autnresponse>

## See Also

- If you haven't created a database for storing objects, first run the action CreateObjectDatabase.
- To add metadata about the object, use the action AddObjectMetadata.
- To add training images of the object, use the action AddObjectImages.
- To add training options that configure training for the object, use the action SetObjectTrainingOption.
- To train Media Server to recognize the object, use the action BuildObject.
- You can use the action TrainObject to add and train a new object, with metadata, training images, and training options, in a single action.

© Copyright 2019 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm