NextGen APIs

POST assets/notifications/r1/notifications

Http Verb

POST

Url

assets/notifications/r1/notifications

Permissions required

Notification: Edit (fsm.notification.edit)

Personally Identifiable Information (PII)

No

Sensitive Information

No

Last Modified Version

r1

Released since

2026 W3 (FSM 24.0)

Deprecated since


Removed since


Tech Tags

multilanguage

Business Logic

This API creates a new notification header.

The insertion task validates the input request checking all the mandatory fields, then

  • validates the operation center/work center relation

  • check that the initial status is OPEN or IN_PROGRESS

  • generates the unique code for the notification

  • sets the generation date if not defined in input with the current instant

  • gets the catalog profile from the specified asset

  • saves the notification header with the associated history record

Header Parameters

Default.

Request Body Parameters

Field

Validations

Note

externalCode



description

NotNull


workCenterId

NotNull


operationCenterId

NotNull


priorityId

NotNull


typeId

NotNull


userId

NotNull


workOrderId



assetId

NotNull


downtime


default = false

breakdownStartDate



breakdownEndDate



generationDate



expectedStartDate



expectedEndDate



generationUserId



workorderGeneratorId



catalogProfileId



externalSystemId



parentNotificationId



statusId

NotNull


failureMode



failureEffect




Response documentation

Response payload fields

Field

Note

id

 

Response error codes

BASE_0003, BASE_0011, NOTIFICATION_0004, NOTIFICATION_0005, NOTIFICATION_0006