Open topic with navigation

# 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.

Note: This is an administrative action that can be sent only from AdminClients (which are set in the `[Server]` section of the configuration file).

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.

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close We welcome your comments! To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm