Asset Upcoming Maintenance Resource

Get Asset Upcoming Maintenance

HTTP Request

GET /api/assetUpcomingMaintenance/{id}

📋 Description: Retrieves upcoming maintenance schedules for a specific asset identified by the provided ID, enabling proactive management of maintenance activities and minimizing operational downtime.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

AssetUpcomingMaintenanceDTO

Example Responses

  1{
  2  "id": 0,
  3  "createdBy": "string",
  4  "createdAt": "2019-08-24T14:15:22Z",
  5  "upcomingMaintenanceDate": "2019-08-24",
  6  "mainAsset": {
  7    "id": 0,
  8    "createdBy": "string",
  9    "createdAt": "2019-08-24T14:15:22Z",
 10    "displayId": "string",
 11    "name": "string",
 12    "description": "string",
 13    "qrCode": "string",
 14    "barCode": "string",
 15    "imageId": 0,
 16    "model": "string",
 17    "manufacturer": "string",
 18    "serialNumber": "string",
 19    "cost": "81.08",
 20    "premiseId": 0,
 21    "premiseDisplayId": "string",
 22    "premiseDto": {
 23      "id": 0,
 24      "createdBy": "string",
 25      "createdAt": "2019-08-24T14:15:22Z",
 26      "displayId": "string",
 27      "premiseName": "string",
 28      "description": "string",
 29      "address": "string",
 30      "internalTeamNames": [
 31        "string"
 32      ],
 33      "internalTeamIds": [
 34        0
 35      ],
 36      "premiseAvailable": true,
 37      "premiseFromNrm": true,
 38      "nlmId": 0,
 39      "nlmDisplayId": "string",
 40      "nlmUsed": true,
 41      "manager": 0,
 42      "managerName": "string",
 43      "imageId": 0,
 44      "area": "string",
 45      "modifiedAt": "2019-08-24T14:15:22Z"
 46    },
 47    "acquisitionDate": "2019-08-24",
 48    "endOfLife": "2019-08-24",
 49    "assetStatusId": 0,
 50    "assetStatus": "string",
 51    "assetStatusType": "string",
 52    "parentAssetId": 0,
 53    "parentAssetDisplayId": "string",
 54    "parentAsset": "string",
 55    "parentAssetDto": {},
 56    "upcomingMaintenanceDate": "2019-08-24",
 57    "assetCategoryIds": [
 58      0
 59    ],
 60    "assetCategories": [
 61      "string"
 62    ],
 63    "internalTeamIds": [
 64      0
 65    ],
 66    "internalTeamDtos": [
 67      {
 68        "id": 0,
 69        "createdBy": "string",
 70        "createdAt": "2019-08-24T14:15:22Z",
 71        "displayId": "string",
 72        "name": "string",
 73        "email": "string",
 74        "phone": "string",
 75        "manager": "string",
 76        "requestCategoryName": [
 77          "string"
 78        ],
 79        "requestCategoryId": [
 80          0
 81        ],
 82        "requestCategoryDisplayId": [
 83          "string"
 84        ],
 85        "description": "string",
 86        "internalTeamUser": [
 87          0
 88        ],
 89        "members": 0,
 90        "mainAssets": [
 91          0
 92        ],
 93        "premiseNames": [
 94          "string"
 95        ],
 96        "internalTeamAvailable": true,
 97        "premiseIds": [
 98          0
 99        ]
100      }
101    ],
102    "internalTeams": [
103      "string"
104    ],
105    "assignedUserIds": [
106      0
107    ],
108    "assignedUserDtos": [
109      {
110        "id": 0,
111        "createdBy": "string",
112        "createdAt": "2019-08-24T14:15:22Z",
113        "userName": "string",
114        "firstName": "string",
115        "lastName": "string",
116        "email": "string",
117        "roleIds": [
118          {
119            "id": 0,
120            "createdBy": "string",
121            "createdAt": "2019-08-24T14:15:22Z",
122            "modifiedBy": "string",
123            "modifiedAt": "2019-08-24T14:15:22Z",
124            "roleName": "string",
125            "entity": "string",
126            "new": true
127          }
128        ],
129        "internalTeamNames": [
130          "string"
131        ],
132        "internalTeamIds": [
133          0
134        ],
135        "internalTeamDisplayIds": [
136          "string"
137        ],
138        "premiseIds": [
139          0
140        ],
141        "premiseNames": [
142          "string"
143        ],
144        "userAvailable": true,
145        "temporaryWorkload": 0,
146        "preferredCultureCode": "string"
147      }
148    ],
149    "assignedUsers": [
150      "string"
151    ],
152    "assetPriority": "string",
153    "assetPriorityId": 0,
154    "assetPriorityDisplayId": "string",
155    "assetPriorityType": "string",
156    "assetAvailable": true,
157    "exactPlacement": "string",
158    "fosId": 0,
159    "downtimeStatus": "string",
160    "premiseFromNrm": true,
161    "modifiedAt": "2019-08-24T14:15:22Z"
162  }
163}

Update Asset Upcoming Maintenance

HTTP Request

PUT /api/assetUpcomingMaintenance/{id}

📋 Description: Updates the upcoming maintenance details for a specified asset, allowing businesses to manage and optimize their maintenance schedules effectively.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

AssetUpcomingMaintenanceDTO

true

Request body containing the updated asset maintenance details, including scheduled dates and maintenance specifications, to ensure timely and efficient asset management.

Body Parameters

  1{
  2  "id": 0,
  3  "createdBy": "string",
  4  "createdAt": "2019-08-24T14:15:22Z",
  5  "upcomingMaintenanceDate": "2019-08-24",
  6  "mainAsset": {
  7    "id": 0,
  8    "createdBy": "string",
  9    "createdAt": "2019-08-24T14:15:22Z",
 10    "displayId": "string",
 11    "name": "string",
 12    "description": "string",
 13    "qrCode": "string",
 14    "barCode": "string",
 15    "imageId": 0,
 16    "model": "string",
 17    "manufacturer": "string",
 18    "serialNumber": "string",
 19    "cost": "81.08",
 20    "premiseId": 0,
 21    "premiseDisplayId": "string",
 22    "premiseDto": {
 23      "id": 0,
 24      "createdBy": "string",
 25      "createdAt": "2019-08-24T14:15:22Z",
 26      "displayId": "string",
 27      "premiseName": "string",
 28      "description": "string",
 29      "address": "string",
 30      "internalTeamNames": [
 31        "string"
 32      ],
 33      "internalTeamIds": [
 34        0
 35      ],
 36      "premiseAvailable": true,
 37      "premiseFromNrm": true,
 38      "nlmId": 0,
 39      "nlmDisplayId": "string",
 40      "nlmUsed": true,
 41      "manager": 0,
 42      "managerName": "string",
 43      "imageId": 0,
 44      "area": "string",
 45      "modifiedAt": "2019-08-24T14:15:22Z"
 46    },
 47    "acquisitionDate": "2019-08-24",
 48    "endOfLife": "2019-08-24",
 49    "assetStatusId": 0,
 50    "assetStatus": "string",
 51    "assetStatusType": "string",
 52    "parentAssetId": 0,
 53    "parentAssetDisplayId": "string",
 54    "parentAsset": "string",
 55    "parentAssetDto": {},
 56    "upcomingMaintenanceDate": "2019-08-24",
 57    "assetCategoryIds": [
 58      0
 59    ],
 60    "assetCategories": [
 61      "string"
 62    ],
 63    "internalTeamIds": [
 64      0
 65    ],
 66    "internalTeamDtos": [
 67      {
 68        "id": 0,
 69        "createdBy": "string",
 70        "createdAt": "2019-08-24T14:15:22Z",
 71        "displayId": "string",
 72        "name": "string",
 73        "email": "string",
 74        "phone": "string",
 75        "manager": "string",
 76        "requestCategoryName": [
 77          "string"
 78        ],
 79        "requestCategoryId": [
 80          0
 81        ],
 82        "requestCategoryDisplayId": [
 83          "string"
 84        ],
 85        "description": "string",
 86        "internalTeamUser": [
 87          0
 88        ],
 89        "members": 0,
 90        "mainAssets": [
 91          0
 92        ],
 93        "premiseNames": [
 94          "string"
 95        ],
 96        "internalTeamAvailable": true,
 97        "premiseIds": [
 98          0
 99        ]
100      }
101    ],
102    "internalTeams": [
103      "string"
104    ],
105    "assignedUserIds": [
106      0
107    ],
108    "assignedUserDtos": [
109      {
110        "id": 0,
111        "createdBy": "string",
112        "createdAt": "2019-08-24T14:15:22Z",
113        "userName": "string",
114        "firstName": "string",
115        "lastName": "string",
116        "email": "string",
117        "roleIds": [
118          {
119            "id": 0,
120            "createdBy": "string",
121            "createdAt": "2019-08-24T14:15:22Z",
122            "modifiedBy": "string",
123            "modifiedAt": "2019-08-24T14:15:22Z",
124            "roleName": "string",
125            "entity": "string",
126            "new": true
127          }
128        ],
129        "internalTeamNames": [
130          "string"
131        ],
132        "internalTeamIds": [
133          0
134        ],
135        "internalTeamDisplayIds": [
136          "string"
137        ],
138        "premiseIds": [
139          0
140        ],
141        "premiseNames": [
142          "string"
143        ],
144        "userAvailable": true,
145        "temporaryWorkload": 0,
146        "preferredCultureCode": "string"
147      }
148    ],
149    "assignedUsers": [
150      "string"
151    ],
152    "assetPriority": "string",
153    "assetPriorityId": 0,
154    "assetPriorityDisplayId": "string",
155    "assetPriorityType": "string",
156    "assetAvailable": true,
157    "exactPlacement": "string",
158    "fosId": 0,
159    "downtimeStatus": "string",
160    "premiseFromNrm": true,
161    "modifiedAt": "2019-08-24T14:15:22Z"
162  }
163}

Responses

Status

Meaning

Description

Schema

200

OK

OK

None

Delete Asset Upcoming Maintenance

HTTP Request

DELETE /api/assetUpcomingMaintenance/{id}

📋 Description: Deletes a specified upcoming maintenance record for an asset, ensuring that outdated or unnecessary maintenance schedules are efficiently managed within the system.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

204

No Content

No Content

None

Get All Asset Upcoming Maintenance

HTTP Request

GET /api/assetUpcomingMaintenance

📋 Description: Retrieves a list of upcoming maintenance schedules for assets, enabling proactive management and planning to minimize downtime and enhance operational efficiency.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Example Responses

  1[
  2  {
  3    "id": 0,
  4    "createdBy": "string",
  5    "createdAt": "2019-08-24T14:15:22Z",
  6    "upcomingMaintenanceDate": "2019-08-24",
  7    "mainAsset": {
  8      "id": 0,
  9      "createdBy": "string",
 10      "createdAt": "2019-08-24T14:15:22Z",
 11      "displayId": "string",
 12      "name": "string",
 13      "description": "string",
 14      "qrCode": "string",
 15      "barCode": "string",
 16      "imageId": 0,
 17      "model": "string",
 18      "manufacturer": "string",
 19      "serialNumber": "string",
 20      "cost": "81.08",
 21      "premiseId": 0,
 22      "premiseDisplayId": "string",
 23      "premiseDto": {
 24        "id": 0,
 25        "createdBy": "string",
 26        "createdAt": "2019-08-24T14:15:22Z",
 27        "displayId": "string",
 28        "premiseName": "string",
 29        "description": "string",
 30        "address": "string",
 31        "internalTeamNames": [
 32          "string"
 33        ],
 34        "internalTeamIds": [
 35          0
 36        ],
 37        "premiseAvailable": true,
 38        "premiseFromNrm": true,
 39        "nlmId": 0,
 40        "nlmDisplayId": "string",
 41        "nlmUsed": true,
 42        "manager": 0,
 43        "managerName": "string",
 44        "imageId": 0,
 45        "area": "string",
 46        "modifiedAt": "2019-08-24T14:15:22Z"
 47      },
 48      "acquisitionDate": "2019-08-24",
 49      "endOfLife": "2019-08-24",
 50      "assetStatusId": 0,
 51      "assetStatus": "string",
 52      "assetStatusType": "string",
 53      "parentAssetId": 0,
 54      "parentAssetDisplayId": "string",
 55      "parentAsset": "string",
 56      "parentAssetDto": {},
 57      "upcomingMaintenanceDate": "2019-08-24",
 58      "assetCategoryIds": [
 59        0
 60      ],
 61      "assetCategories": [
 62        "string"
 63      ],
 64      "internalTeamIds": [
 65        0
 66      ],
 67      "internalTeamDtos": [
 68        {
 69          "id": 0,
 70          "createdBy": "string",
 71          "createdAt": "2019-08-24T14:15:22Z",
 72          "displayId": "string",
 73          "name": "string",
 74          "email": "string",
 75          "phone": "string",
 76          "manager": "string",
 77          "requestCategoryName": [
 78            "string"
 79          ],
 80          "requestCategoryId": [
 81            0
 82          ],
 83          "requestCategoryDisplayId": [
 84            "string"
 85          ],
 86          "description": "string",
 87          "internalTeamUser": [
 88            0
 89          ],
 90          "members": 0,
 91          "mainAssets": [
 92            0
 93          ],
 94          "premiseNames": [
 95            "string"
 96          ],
 97          "internalTeamAvailable": true,
 98          "premiseIds": [
 99            0
100          ]
101        }
102      ],
103      "internalTeams": [
104        "string"
105      ],
106      "assignedUserIds": [
107        0
108      ],
109      "assignedUserDtos": [
110        {
111          "id": 0,
112          "createdBy": "string",
113          "createdAt": "2019-08-24T14:15:22Z",
114          "userName": "string",
115          "firstName": "string",
116          "lastName": "string",
117          "email": "string",
118          "roleIds": [
119            {
120              "id": 0,
121              "createdBy": "string",
122              "createdAt": "2019-08-24T14:15:22Z",
123              "modifiedBy": "string",
124              "modifiedAt": "2019-08-24T14:15:22Z",
125              "roleName": "string",
126              "entity": "string",
127              "new": true
128            }
129          ],
130          "internalTeamNames": [
131            "string"
132          ],
133          "internalTeamIds": [
134            0
135          ],
136          "internalTeamDisplayIds": [
137            "string"
138          ],
139          "premiseIds": [
140            0
141          ],
142          "premiseNames": [
143            "string"
144          ],
145          "userAvailable": true,
146          "temporaryWorkload": 0,
147          "preferredCultureCode": "string"
148        }
149      ],
150      "assignedUsers": [
151        "string"
152      ],
153      "assetPriority": "string",
154      "assetPriorityId": 0,
155      "assetPriorityDisplayId": "string",
156      "assetPriorityType": "string",
157      "assetAvailable": true,
158      "exactPlacement": "string",
159      "fosId": 0,
160      "downtimeStatus": "string",
161      "premiseFromNrm": true,
162      "modifiedAt": "2019-08-24T14:15:22Z"
163    }
164  }
165]

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[AssetUpcomingMaintenanceDTO]

false

none

[Data transfer object representing the upcoming maintenance schedule for assets, including relevant details such as maintenance dates and associated asset identifiers, to facilitate proactive asset management and operational efficiency.]

» id

integer(int64)

false

none

Unique identifier for the resource

» createdBy

string

false

none

Username of who created this resource

» createdAt

string(date-time)

false

none

Timestamp when this resource was created

» upcomingMaintenanceDate

string(date)

false

none

Date of the upcoming maintenance

» mainAsset

MainAssetDTO

false

none

MainAssetDTO is a data transfer object that encapsulates key information about a primary asset within the organization, including its attributes, status, and associated metadata, facilitating effective asset management and decision-making.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» createdBy

string

false

none

Username of who created this resource

»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»» displayId

string

false

none

Unique identifier for the display

»» name

string

false

none

Name of the resource

»» description

string

false

none

Description of the resource

»» qrCode

string

false

none

Code for the qr

»» barCode

string

false

none

Code for the bar

»» imageId

integer(int64)

false

none

Unique identifier for the image

»» model

string

false

none

Specifies the model associated with the main asset, providing essential context for asset classification and management.

»» manufacturer

string

false

none

Name of the manufacturer associated with the asset, providing essential information for inventory management and supplier relations.

»» serialNumber

string

false

none

Unique identifier for the asset, used to track and manage inventory within the system.

»» cost

string

false

none

Represents the total cost associated with the main asset, providing essential financial information for budgeting and resource allocation.

»» premiseId

integer(int64)

false

none

Unique identifier for the premise

»» premiseDisplayId

string

false

none

Unique identifier for the premise display

»» premiseDto

PremiseDTO

false

none

Data transfer object representing a premise, encapsulating essential details such as location, type, and associated attributes to facilitate effective decision-making in real estate and operational planning.

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» createdBy

string

false

none

Username of who created this resource

»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»» displayId

string

false

none

Unique identifier for the display

»»» premiseName

string

false

none

Name of the premise

»»» description

string

false

none

Description of the resource

»»» address

string

true

none

Represents the physical location associated with the premise, essential for logistics and service delivery.

»»» internalTeamNames

[string]

false

none

List of names representing the internal teams associated with the premise, facilitating streamlined collaboration and resource allocation within the organization.

»»» internalTeamIds

[integer]

false

none

List of unique identifiers representing the internal teams associated with the premise, facilitating streamlined collaboration and resource allocation.

»»» premiseAvailable

boolean

false

none

Indicates whether the premise is available for use within the specified context.

»»» premiseFromNrm

boolean

false

none

Indicates whether the premise is sourced from the National Resource Management (NRM) framework, facilitating compliance and reporting within environmental management processes.

»»» nlmId

integer(int64)

false

none

Unique identifier for the nlm

»»» nlmDisplayId

string

false

none

Unique identifier for the nlm display

»»» nlmUsed

boolean

false

none

Indicates whether the National Labor Market (NLM) resources have been utilized in the premise evaluation process.

»»» manager

integer(int64)

false

none

Unique identifier for the manager associated with the premise, facilitating effective organizational hierarchy and resource management.

»»» managerName

string

false

none

Name of the manager

»»» imageId

integer(int64)

false

none

Unique identifier for the image

»»» area

string

false

none

Represents the geographic area associated with the premise, providing essential context for location-based services and analysis.

»»» modifiedAt

string(date-time)

false

none

Timestamp when this resource was last modified

»» acquisitionDate

string(date)

false

none

Date of the acquisition

»» endOfLife

string(date)

false

none

Indicates the end-of-life date for the asset, providing critical information for lifecycle management and planning.

»» assetStatusId

integer(int64)

false

none

Unique identifier for the asset status

»» assetStatus

string

false

none

Status of the asset

»» assetStatusType

string

false

none

Type of the asset status

»» parentAssetId

integer(int64)

false

none

Unique identifier for the parent asset

»» parentAssetDisplayId

string

false

none

Unique identifier for the parent asset display

»» parentAsset

string

false

none

Identifier for the parent asset associated with the main asset, facilitating hierarchical relationships within asset management.

»» parentAssetDto

MainAssetDTO

false

none

MainAssetDTO is a data transfer object that encapsulates key information about a primary asset within the organization, including its attributes, status, and associated metadata, facilitating effective asset management and decision-making.

»» upcomingMaintenanceDate

string(date)

false

none

Date of the upcoming maintenance

»» assetCategoryIds

[integer]

false

none

Array of unique identifiers representing the categories to which the asset belongs, facilitating effective asset classification and management.

»» assetCategories

[string]

false

none

Array of asset categories that classify the main assets within the system, facilitating better organization and management of asset data.

»» internalTeamIds

[integer]

false

none

Array of unique identifiers representing the internal teams associated with the main asset, facilitating streamlined collaboration and resource allocation.

»» internalTeamDtos

[InternalTeamDTO]

false

none

An array of MainAssetDTO objects representing the internal teams associated with the asset, facilitating effective resource management and collaboration within the organization.

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» createdBy

string

false

none

Username of who created this resource

»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»» displayId

string

false

none

Unique identifier for the display

»»» name

string

false

none

Name of the resource

»»» email

string

false

none

Email address of the internal team member, used for communication and notifications within the organization.

»»» phone

string

false

none

Contact number for the internal team, facilitating communication and collaboration within the organization.

»»» manager

string

false

none

Represents the name or identifier of the team manager responsible for overseeing the internal team.

»»» requestCategoryName

[string]

false

none

Name of the request category

»»» requestCategoryId

[integer]

false

none

Unique identifier for the request category

»»» requestCategoryDisplayId

[string]

false

none

Unique identifier for the request category display

»»» description

string

false

none

Description of the resource

»»» internalTeamUser

[integer]

false

none

An array of InternalTeamDTO objects representing the users within the internal team, facilitating collaboration and resource management.

»»» members

integer(int32)

false

none

Represents the total number of members within the internal team, providing insight into team size for resource allocation and management.

»»» mainAssets

[integer]

false

none

An array of internal team assets that represent the key resources and capabilities utilized within the organization.

»»» premiseNames

[string]

false

none

List of names associated with the premises relevant to the internal team, facilitating efficient identification and management of locations within the organization.

»»» internalTeamAvailable

boolean

false

none

Indicates the availability of the internal team for project allocation and resource planning.

»»» premiseIds

[integer]

false

none

Array of unique identifiers representing the premises associated with the internal team.

»» internalTeams

[string]

false

none

An array of internal teams associated with the main asset, facilitating collaboration and resource allocation within the organization.

»» assignedUserIds

[integer]

false

none

Array of unique identifiers representing users assigned to the main asset, facilitating effective resource management and accountability.

»» assignedUserDtos

[UserDTO]

false

none

Array of user assignments associated with the main asset, providing insights into resource allocation and accountability.

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» createdBy

string

false

none

Username of who created this resource

»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»» userName

string

false

none

Name of the user

»»» firstName

string

false

none

Name of the first

»»» lastName

string

false

none

Name of the last

»»» email

string

false

none

Email address of the user, used for communication and account verification purposes within the system.

»»» roleIds

[Role]

false

none

Array of unique identifiers representing the roles assigned to the user, facilitating role-based access and permissions within the system.

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» createdBy

string

false

none

Username of who created this resource

»»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»»» modifiedBy

string

false

none

Username of who last modified this resource

»»»» modifiedAt

string(date-time)

false

none

Timestamp when this resource was last modified

»»»» roleName

string

false

none

Name of the role

»»»» entity

string

false

none

Represents the specific role associated with the entity within the organizational structure, facilitating effective resource allocation and management.

»»»» new

boolean

false

none

Indicates whether the role is newly created within the system, facilitating effective management of organizational changes.

»»» internalTeamNames

[string]

false

none

List of names representing the internal teams associated with the user, facilitating effective collaboration and resource allocation within the organization.

»»» internalTeamIds

[integer]

false

none

An array of unique identifiers representing the internal teams associated with the user, facilitating team management and collaboration within the organization.

»»» internalTeamDisplayIds

[string]

false

none

An array of unique identifiers representing the internal teams associated with the user, facilitating streamlined team management and collaboration.

»»» premiseIds

[integer]

false

none

Array of unique identifiers representing the premises associated with the user, facilitating efficient management and tracking of user-related locations.

»»» premiseNames

[string]

false

none

List of names associated with the user’s premises, providing essential context for location-based services and operations.

»»» userAvailable

boolean

false

none

Indicates whether the user is available for assignment or engagement within the system.

»»» temporaryWorkload

integer(int32)

false

none

Represents the temporary workload allocation for the user, measured in integer units, to facilitate effective resource management and planning.

»»» preferredCultureCode

string

false

none

Code for the preferred culture

»» assignedUsers

[string]

false

none

List of users assigned to the main asset, facilitating effective resource management and collaboration within the organization.

»» assetPriority

string

false

none

Priority of the asset

»» assetPriorityId

integer(int64)

false

none

Unique identifier for the asset priority

»» assetPriorityDisplayId

string

false

none

Unique identifier for the asset priority display

»» assetPriorityType

string

false

none

Type of the asset priority

»» assetAvailable

boolean

false

none

Indicates whether the asset is currently available for allocation or use within the system.

»» exactPlacement

string

false

none

Specifies the precise location or context in which the main asset is intended to be utilized within the business framework.

»» fosId

integer(int64)

false

none

Unique identifier for the fos

»» downtimeStatus

string

false

none

Status of the downtime

»» premiseFromNrm

boolean

false

none

Indicates whether the asset is sourced from the National Resource Management (NRM) framework, facilitating compliance and resource tracking.

»» modifiedAt

string(date-time)

false

none

Timestamp when this resource was last modified

Create Asset Upcoming Maintenance

HTTP Request

POST /api/assetUpcomingMaintenance

📋 Description: Submits a request to schedule upcoming maintenance for specified assets, ensuring proactive management and optimization of asset performance.

Parameters

Name

In

Type

Required

Description

body

body

AssetUpcomingMaintenanceDTO

true

Request body containing details of upcoming maintenance activities for assets, including asset identifiers, scheduled dates, and maintenance descriptions.

Body Parameters

  1{
  2  "id": 0,
  3  "createdBy": "string",
  4  "createdAt": "2019-08-24T14:15:22Z",
  5  "upcomingMaintenanceDate": "2019-08-24",
  6  "mainAsset": {
  7    "id": 0,
  8    "createdBy": "string",
  9    "createdAt": "2019-08-24T14:15:22Z",
 10    "displayId": "string",
 11    "name": "string",
 12    "description": "string",
 13    "qrCode": "string",
 14    "barCode": "string",
 15    "imageId": 0,
 16    "model": "string",
 17    "manufacturer": "string",
 18    "serialNumber": "string",
 19    "cost": "81.08",
 20    "premiseId": 0,
 21    "premiseDisplayId": "string",
 22    "premiseDto": {
 23      "id": 0,
 24      "createdBy": "string",
 25      "createdAt": "2019-08-24T14:15:22Z",
 26      "displayId": "string",
 27      "premiseName": "string",
 28      "description": "string",
 29      "address": "string",
 30      "internalTeamNames": [
 31        "string"
 32      ],
 33      "internalTeamIds": [
 34        0
 35      ],
 36      "premiseAvailable": true,
 37      "premiseFromNrm": true,
 38      "nlmId": 0,
 39      "nlmDisplayId": "string",
 40      "nlmUsed": true,
 41      "manager": 0,
 42      "managerName": "string",
 43      "imageId": 0,
 44      "area": "string",
 45      "modifiedAt": "2019-08-24T14:15:22Z"
 46    },
 47    "acquisitionDate": "2019-08-24",
 48    "endOfLife": "2019-08-24",
 49    "assetStatusId": 0,
 50    "assetStatus": "string",
 51    "assetStatusType": "string",
 52    "parentAssetId": 0,
 53    "parentAssetDisplayId": "string",
 54    "parentAsset": "string",
 55    "parentAssetDto": {},
 56    "upcomingMaintenanceDate": "2019-08-24",
 57    "assetCategoryIds": [
 58      0
 59    ],
 60    "assetCategories": [
 61      "string"
 62    ],
 63    "internalTeamIds": [
 64      0
 65    ],
 66    "internalTeamDtos": [
 67      {
 68        "id": 0,
 69        "createdBy": "string",
 70        "createdAt": "2019-08-24T14:15:22Z",
 71        "displayId": "string",
 72        "name": "string",
 73        "email": "string",
 74        "phone": "string",
 75        "manager": "string",
 76        "requestCategoryName": [
 77          "string"
 78        ],
 79        "requestCategoryId": [
 80          0
 81        ],
 82        "requestCategoryDisplayId": [
 83          "string"
 84        ],
 85        "description": "string",
 86        "internalTeamUser": [
 87          0
 88        ],
 89        "members": 0,
 90        "mainAssets": [
 91          0
 92        ],
 93        "premiseNames": [
 94          "string"
 95        ],
 96        "internalTeamAvailable": true,
 97        "premiseIds": [
 98          0
 99        ]
100      }
101    ],
102    "internalTeams": [
103      "string"
104    ],
105    "assignedUserIds": [
106      0
107    ],
108    "assignedUserDtos": [
109      {
110        "id": 0,
111        "createdBy": "string",
112        "createdAt": "2019-08-24T14:15:22Z",
113        "userName": "string",
114        "firstName": "string",
115        "lastName": "string",
116        "email": "string",
117        "roleIds": [
118          {
119            "id": 0,
120            "createdBy": "string",
121            "createdAt": "2019-08-24T14:15:22Z",
122            "modifiedBy": "string",
123            "modifiedAt": "2019-08-24T14:15:22Z",
124            "roleName": "string",
125            "entity": "string",
126            "new": true
127          }
128        ],
129        "internalTeamNames": [
130          "string"
131        ],
132        "internalTeamIds": [
133          0
134        ],
135        "internalTeamDisplayIds": [
136          "string"
137        ],
138        "premiseIds": [
139          0
140        ],
141        "premiseNames": [
142          "string"
143        ],
144        "userAvailable": true,
145        "temporaryWorkload": 0,
146        "preferredCultureCode": "string"
147      }
148    ],
149    "assignedUsers": [
150      "string"
151    ],
152    "assetPriority": "string",
153    "assetPriorityId": 0,
154    "assetPriorityDisplayId": "string",
155    "assetPriorityType": "string",
156    "assetAvailable": true,
157    "exactPlacement": "string",
158    "fosId": 0,
159    "downtimeStatus": "string",
160    "premiseFromNrm": true,
161    "modifiedAt": "2019-08-24T14:15:22Z"
162  }
163}

Responses

Status

Meaning

Description

Schema

201

Created

Created

integer

Example Responses

10