Push Object metadata API faulty ?

Answered

Phạm Quang Đăng

January 27, 2026 09:14

Im using the new API to push Object Metadata:
/rest/v4/analytics/engines/{id}/deviceAgents/{deviceId}/metadata/object

- I acquired Engine ID from API /rest/v4/analytics/engines :
  {

    "id": "9374a422-8710-fb8f-35cd-a89b12dffbba",

    "name": "Stub, Custom Metadata",

    "integrationId": "512fffe5-28b7-dd77-c07a-518ec16b146c"

  },

- I acquired Engine ID from API DeviceId from /rest/v4/devices :
{ …id: “a32e1c65-db8b-8695-9934-00e94c13fd9b”, … }


- Then i try the Push Object metadata API on the website https://meta.nxvms.com/doc/developers/api-tool/rest-v4-analytics-engines-id-deviceagents-deviceid-metadata-object-post with this payload:
{
 "flags": "none",
 "timestampMs": 1769504580000,
 "durationMs": 0,
 "objects": [
   {
     "trackId": “1c7ed2c8-9933-4114-8053-4912c6a7fcfa”,
     "subtype": "",
     "boundingBox": "0.1,0.1,0.2x0.2",
     "typeId": "nx.stub.customMetadata",
     "confidence": 0,
     "attributes": [
       {
         "type": "String",
         "name": "Name",
         "value": "Dang",
         "confidence": 0
       }
     ]
   }
 ]
}


- The server response like this:
{

  "error": "9",

  "errorId": "notFound",

  "errorString": "Integration Request data was not found, User id: {c8f35c62-9fd3-02c4-7aa3-d4718882b352}."

}

=> Why was the Integration Request data not found ? Do i need to setup anything else ?

My system:
+ Ubuntu 22.04
+ NX Meta 6.1.0.42176
+ Stub custom Metadata plugin was enabled in camera settings and i restarted the server.

0

• 

  Ichiro

  • Network Optix team

  January 27, 2026 16:04

  Hi 

  This is expected behavior. You can see the integration has two types: api and sdk, and only API integration can use these API for the operations.
   

  

   

  In your case, you are trying to use API integration tool on SDK integration plugin, this is not allowed at the moment. There is a main difference of API and SDK integration, the API integration will have a integration user for each integration, however SDK will not, this also explains the error message about the user Id. 

  The restriction might be documented in the API documentation, but it seems not be emphasized, and likely not very clear. We will check with the documentation team to see if there will be an improvement in the future.

  
  Note that in the Server HTTP API there are also functions related to the Analytics domain but are intended to be called by Clients connected to a Server. They are not intended to be used by the Analytics API.

  We don't have the plan to extend the API to SDK integration at the moment within near future release, in short -Only API integrations can use REST API to send data and SDK integrations will call SDK methods, function call in C++.

  Thanks. 

  0
• 

  Phạm Quang Đăng

  January 28, 2026 02:03

  Thank you very much this explains a lot

  0

Please sign in to leave a comment.