Assets

Create accessory asset history note

Add a note to the accessory asset history

post/api/v2/assets/accessories/{id}/history

Request

Path parameters

idstring required

The accessory asset ID

Request body

notestring required

The content of the note to add to asset history

Example request

{
  "note": "Asset transferred to new department"
}

Response

History note created successfully

eventType'ASSET_HISTORY_EVENT_TYPE_CREATE' | 'ASSET_HISTORY_EVENT_TYPE_DELETE' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_FIELDS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_LOCATION' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_OWNER' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_AGENT_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_MFA_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_UPDATE_MDM_STATUS' | 'ASSET_HISTORY_EVENT_TYPE_NOTE' required

The type of history event

notestring

Note content for note events

occurredAtstring date-time required

When the event occurred

actionSource'ACTION_SOURCE_MANUAL' | 'ACTION_SOURCE_SYSTEM' | 'ACTION_SOURCE_IMPORT' | 'ACTION_SOURCE_API' required

Source of the action

Example response

{
  "eventType": "ASSET_HISTORY_EVENT_TYPE_NOTE",
  "note": "Asset transferred to new department",
  "changedFields": [
    {
      "label": "Status"
    }
  ],
  "occurredAt": "2024-01-15T10:30:00",
  "actor": {
    "id": "507f1f77bcf86cd799439011",
    "name": "John Doe",
    "type": "ACTOR_TYPE_USER"
  },
  "actionSource": "ACTION_SOURCE_MANUAL"
}

Changes

No recorded changes to this operation across all 1 revision of this API.