Sign in

v51

latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-01245104440.0 KB
Asset Management Schema

Create a new asset attribute

Create a new asset attribute definition. Requires "Manage asset management schema" system access right.

post/v1/asset-management-schema

Request body

namestring required

Unique attribute name. Must match the pattern ^[A-Za-z$][A-Za-z0-9$]*$. Immutable after creation.

displayNamestring

Human-readable display name.

dataType'String' | 'Integer' | 'Number' | 'Boolean' | 'Enum' | 'MacAddress' | 'IPAddress' | 'UUID' | 'ObjectReference' | 'Date'

Attribute data type. Accepts the symbolic name (or, for backward compatibility, the numeric code) on input; always returned as the symbolic name.

isMandatoryboolean

Whether a value for this attribute is mandatory on assets.

isUniqueboolean

Whether the attribute value must be unique across all assets.

isHiddenboolean

Whether the attribute is hidden in the UI.

autofillScriptstring

NXSL script used to automatically populate the attribute value.

rangeMininteger

Minimum value (for numeric types) or minimum length (for strings). 0 means unset.

rangeMaxinteger

Maximum value (for numeric types) or maximum length (for strings). 0 means unset.

systemType'None' | 'Serial' | 'IPAddress' | 'MacAddress' | 'Vendor' | 'Model'

System type binding for the attribute. Accepts the symbolic name (or the numeric code) on input; always returned as the symbolic name.

enumMapobject

For the Enum data type, the map of allowed values to their display names.

Response

Asset attribute created successfully.

namestring required

Unique attribute name. Must match the pattern ^[A-Za-z$][A-Za-z0-9$]*$. Immutable after creation.

displayNamestring

Human-readable display name.

dataType'String' | 'Integer' | 'Number' | 'Boolean' | 'Enum' | 'MacAddress' | 'IPAddress' | 'UUID' | 'ObjectReference' | 'Date'

Attribute data type. Accepts the symbolic name (or, for backward compatibility, the numeric code) on input; always returned as the symbolic name.

isMandatoryboolean

Whether a value for this attribute is mandatory on assets.

isUniqueboolean

Whether the attribute value must be unique across all assets.

isHiddenboolean

Whether the attribute is hidden in the UI.

autofillScriptstring

NXSL script used to automatically populate the attribute value.

rangeMininteger

Minimum value (for numeric types) or minimum length (for strings). 0 means unset.

rangeMaxinteger

Maximum value (for numeric types) or maximum length (for strings). 0 means unset.

systemType'None' | 'Serial' | 'IPAddress' | 'MacAddress' | 'Vendor' | 'Model'

System type binding for the attribute. Accepts the symbolic name (or the numeric code) on input; always returned as the symbolic name.

enumMapobject

For the Enum data type, the map of allowed values to their display names.