Sign in

v2

latestOpenAPI 3.0.12026-07-263104131.9 MB
Custom Fields

Create a new custom field

Creates a new custom field (node attribute) with the specified configuration

post/v2/custom-fields

Request body

labelstring required

Display label for the custom field

fieldNamestring required

Unique field name for API access (used when accessing the value programmatically)

descriptionstring

Description of the custom field

type'DROPDOWN' | 'MULTI_SELECT' | 'CHECKBOX' | 'TEXT' | 'TEXT_MULTILINE' | 'TEXT_ENCRYPTED' | 'NUMERIC' | 'DECIMAL' | 'DATE' | 'DATE_TIME' | 'TIME' | 'ATTACHMENT' | 'NODE_DROPDOWN' | 'NODE_MULTI_SELECT' | 'CLIENT_DROPDOWN' | 'CLIENT_MULTI_SELECT' | 'CLIENT_LOCATION_DROPDOWN' | 'CLIENT_LOCATION_MULTI_SELECT' | 'CLIENT_DOCUMENT_DROPDOWN' | 'CLIENT_DOCUMENT_MULTI_SELECT' | 'EMAIL' | 'PHONE' | 'IP_ADDRESS' | 'WYSIWYG' | 'URL' | 'MONETARY' | 'IDENTIFIER' | 'TOTP'

The type of custom field that determines how data is stored and displayed

technicianPermission'NONE' | 'EDITABLE' | 'READ_ONLY' | 'ROLE_BASED'

Technician access level for custom fields

scriptPermission'NONE' | 'READ_ONLY' | 'WRITE_ONLY' | 'READ_WRITE'

Script access level for custom fields via automation

apiPermission'NONE' | 'READ_ONLY' | 'WRITE_ONLY' | 'READ_WRITE'

Public API access level for custom fields (NOTE: This permission affects attribute VALUES, not attributes themselves)

defaultValuestring

Default value for the custom field. This only has an effect for DROPDOWN and MULTI_SELECT attributes

scope'NODE_GLOBAL' | 'NODE_ROLE' | 'NODE_CLASS'

Scope that determines where the custom field applies (NOTE: This is depricated and will be removed in a future release. The use of DefinitionScope is strongly preferred)

definitionScopestring[]

Definition scope for the custom field

groupIdinteger

Group ID for organizing custom fields

addToDefaultTabboolean

Whether to add to the default tab

Response

Custom field created successfully

entityType'USER' | 'NODE' | 'TICKET' | 'DOCUMENT'

Entity type that this custom field or operation applies to

scope'NODE_GLOBAL' | 'NODE_ROLE' | 'NODE_CLASS'

Scope that determines where the custom field applies (NOTE: This is depricated and will be removed in a future release. The use of DefinitionScope is strongly preferred)

definitionScopestring[]

Definition Scope

type'DROPDOWN' | 'MULTI_SELECT' | 'CHECKBOX' | 'TEXT' | 'TEXT_MULTILINE' | 'TEXT_ENCRYPTED' | 'NUMERIC' | 'DECIMAL' | 'DATE' | 'DATE_TIME' | 'TIME' | 'ATTACHMENT' | 'NODE_DROPDOWN' | 'NODE_MULTI_SELECT' | 'CLIENT_DROPDOWN' | 'CLIENT_MULTI_SELECT' | 'CLIENT_LOCATION_DROPDOWN' | 'CLIENT_LOCATION_MULTI_SELECT' | 'CLIENT_DOCUMENT_DROPDOWN' | 'CLIENT_DOCUMENT_MULTI_SELECT' | 'EMAIL' | 'PHONE' | 'IP_ADDRESS' | 'WYSIWYG' | 'URL' | 'MONETARY' | 'IDENTIFIER' | 'TOTP'

The type of custom field that determines how data is stored and displayed

labelstring

Label

descriptionstring

Description

namestring

Name

defaultValuestring

Default Value

endUserPermission'HIDDEN' | 'EDITABLE_OPTIONAL' | 'EDITABLE_REQUIRED' | 'READ_ONLY'

End user access level for custom fields in the UI

technicianPermission'NONE' | 'EDITABLE' | 'READ_ONLY' | 'ROLE_BASED'

Technician access level for custom fields

scriptPermission'NONE' | 'READ_ONLY' | 'WRITE_ONLY' | 'READ_WRITE'

Script access level for custom fields via automation

apiPermission'NONE' | 'READ_ONLY' | 'WRITE_ONLY' | 'READ_WRITE'

Public API access level for custom fields (NOTE: This permission affects attribute VALUES, not attributes themselves)

systemboolean

System

activeboolean

Active

createTimenumber double

Create Time

updateTimenumber double

Update Time