Media Server 25.4
Media Server Help

# 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 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.4

Topic Title: NewObject