---
title: "Get object tool details"
method: GET
path: "/v1/object-tools/{tool-id}"
tags: ["Object Tools"]
---

# Get object tool details

`GET /v1/object-tools/{tool-id}`

Retrieve full details of a specific object tool. When the caller has
SYSTEM_ACCESS_MANAGE_TOOLS rights the response additionally includes the
`acl` and (for snmp-table / agent-list tools) `columns` fields.

## Path parameters

- `tool-id` integer, required

## Response `200`

Successful retrieval of object tool details.

- ObjectToolDetails
  - `id` integer — Tool ID
  - `name` string — Tool name
  - `type` 'action' | 'snmp-table' | 'agent-list' | 'url' | 'command' | 'server-command' | 'file-download' | 'server-script' | 'agent-table' | 'ssh-command' — Type of object tool
  - `flags` object — Tool flags
    - `askConfirmation` boolean — Whether to ask for user confirmation before execution
    - `generatesOutput` boolean — Whether the tool generates output
    - `disabled` boolean — Whether the tool is disabled
    - `showInCommands` boolean — Whether to show in commands menu
    - `snmpIndexedByValue` boolean — Whether SNMP is indexed by value
    - `runInContainerContext` boolean — Whether to run in container context
    - `suppressSuccessMessage` boolean — Whether to suppress success message
    - `setupTcpTunnel` boolean — Whether to setup TCP tunnel
  - `confirmationMessage` string — Confirmation message shown to user
  - `commandName` string — Full command name
  - `commandShortName` string — Short command name
  - `remotePort` integer — Remote port for TCP tunnel
  - `remoteHost` string — Remote host for TCP tunnel
  - `applicableClasses` integer — 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.
  - `inputFields` ObjectToolInputField[] — Input field definitions
    - `name` string — Field name
    - `type` integer — Field type
    - `displayName` string — Display name for the field
    - `defaultValue` string — Default value for the field
    - `flags` integer — Field flags
    - `sequence` integer — Field sequence order
  - `data` string — Tool-specific data
  - `description` string — Tool description
  - `filter` string — Tool filter (matching OID for SNMP tools)
  - `icon` string, uuid — UUID of the icon image in the image library; absent when no icon is set
  - `acl` integer[] — User and group IDs allowed to execute this tool. Only present when the caller has SYSTEM_ACCESS_MANAGE_TOOLS rights.
  - `columns` ObjectToolColumn[] — Column definitions for table tools. Only present when the caller has SYSTEM_ACCESS_MANAGE_TOOLS rights and the tool type is snmp-table or agent-list.
    - `name` string — Column display name
    - `oid` string — Column SNMP OID or agent column expression
    - `format` integer — Column data format code
    - `captureGroup` integer — Regex capture group number used to extract the cell value (0 for whole match)
  - `translations` ObjectToolTranslation[] — Localized string overrides for tool name, description, and input field labels. Only present when the caller has SYSTEM_ACCESS_MANAGE_TOOLS rights and at least one translation exists.
    - `field` string — Tag identifying which string is translated (e.g. tool name, description, or an input field label)
    - `language` string — Language code the translation applies to
    - `value` string — Translated string value

## Other responses

- `400` — Invalid tool ID.
- `403` — Access denied.
- `404` — Tool not found.
- `500` — Database failure.

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)