v51

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01245104440.0 KB

Objects

Get node agent communication configuration

Return the node's NetXMS agent communication settings (the same shape accepted by the matching PATCH). The sharedSecret is included only when the caller has modify or read-credentials access to the object.

This property group applies to Node objects only; requesting it for any other object class returns 400.

get/v1/objects/{object-id}/agent

Path parameters

object-idinteger required

Response

Agent communication configuration.

portinteger

Agent TCP port.

proxyinteger nullable

ID of the node used as agent proxy, or 0 for no proxy.

sharedSecretstring nullable

Agent shared secret (write-only).

forceEncryptionboolean

Require encryption for agent communication.

tunnelOnlyboolean

Accept agent connections only through an established agent tunnel.

cacheMode'default' | 'on' | 'off'

Agent-side DCI value caching mode.

compressionMode'default' | 'enabled' | 'disabled'

Agent communication protocol compression mode.

certificateMappingMethod'subject' | 'publicKey' | 'commonName' | 'templateId'

Method used to map the agent's certificate to this node for authentication.

certificateMappingDatastring nullable

Certificate mapping data (interpretation depends on certificateMappingMethod).