NextGen APIs

POST assets/notifications/r1/notifications/{notificationId}/positions


Http Verb

POST

Url

assets/notifications/r1/notifications/{notificationId}/positions

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


Business Logic

This API adds a new notification position linked to the specified notification header.

The insert task validates the input as follows:

  1. Notification header must exist

  2. Notification header status must be OPEN or IN_PROGRESS

  3. Asset validation: catalog code type’s entity type must be OBJECT

  4. Breakdown validation: catalog code type’s entity type must be ANOMALY

The position’s initial status is VALID, and its number is automatically set to 000#, where # equals the highest position number linked to the header plus 1.

Path Parameters

Field

Note

notificationId


Header Parameters

Default.

Request Body Parameters

Field

Note

description


assetCatalogCodeId


assetDescription


breakdownCatalogCodeId


breakdownDescription


externalCode


Response documentation

Response payload fields

Field

Note

id

 

Response error codes

NOT_FOUND

BASE_0001

BASE_0003

BASE_0011

NOTIFICATION_0012

NOTIFICATION_0013

NOTIFICATION_0014