Sign in

v51

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

Create a new object tool

Create a new object tool. The server assigns the tool ID and GUID. Requires SYSTEM_ACCESS_MANAGE_TOOLS.

post/v1/object-tools

Request body

namestring required

Tool name

type'internal' | 'action' | 'snmp-table' | 'agent-list' | 'url' | 'command' | 'server-command' | 'file-download' | 'server-script' | 'agent-table' | 'ssh-command' required

Type of object tool

datastring

Tool-specific data (command line, script name, URL template, etc.)

descriptionstring
filterstring
confirmationMessagestring
commandNamestring
commandShortNamestring
iconstring uuid

UUID of an existing image library entry; omit or use null UUID for no icon

remotePortinteger
remoteHoststring
applicableClassesinteger

Bitmask of applicable object classes. Bit 0 (1) = Node, bit 1 (2) = Interface, bit 2 (4) = Sensor, bit 3 (8) = Access point. Defaults are applied if 0 or missing: URL tools default to all classes, others to Node. Non-Node bits are stripped for tool types other than server-script, url and ssh-command.

aclinteger[]

User and group IDs allowed to execute this tool. Replaces the existing ACL on PUT. Send an empty array to remove all entries.

Response

Object tool created.

idinteger

Tool ID

namestring

Tool name

type'internal' | 'action' | 'snmp-table' | 'agent-list' | 'url' | 'command' | 'server-command' | 'file-download' | 'server-script' | 'agent-table' | 'ssh-command'

Type of object tool

confirmationMessagestring

Confirmation message shown to user

commandNamestring

Full command name

commandShortNamestring

Short command name

remotePortinteger

Remote port for TCP tunnel

remoteHoststring

Remote host for TCP tunnel

applicableClassesinteger

Bitmask of object classes the tool is applicable to. Bit 0 (1) = Node, bit 1 (2) = Interface, bit 2 (4) = Sensor, bit 3 (8) = Access point. Only server-script and URL tools may include bits other than Node.

datastring

Tool-specific data

descriptionstring

Tool description

filterstring

Tool filter (matching OID for SNMP tools)

iconstring uuid

UUID of the icon image in the image library; absent when no icon is set

aclinteger[]

User and group IDs allowed to execute this tool. Only present when the caller has SYSTEM_ACCESS_MANAGE_TOOLS rights.