---
title: "Create accessory asset history note"
method: POST
path: "/assets/accessories/{id}/history"
tags: ["Assets"]
---

# Create accessory asset history note

`POST /assets/accessories/{id}/history`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/assets/accessories/{id}/history`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/assets/accessories/:id/history/post.ts> (a function with typed inputs; its response is checked against the schema)

Add a note to the accessory asset history

## Path parameters

- `id` string, required

## Request body

- JumpcloudHttpAssetsCreateAssetHistoryNoteRequest: Request payload for creating a note entry in asset history
  - `note` string, required: The content of the note to add to asset history

## Response `201`

History note created successfully

- JumpcloudHttpAssetsAssetHistoryEvent: Represents a historical event that occurred on an asset
  - `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
  - `note` string: Note content for note events
  - `changedFields` JumpcloudHttpAssetsFieldChange[]
    - `label` string, required: The field label that changed
    - `oldValue` JumpcloudHttpAssetsChangeValue: Represents a field value in asset history (before/after change)
      - `value` unknown
    - `newValue` JumpcloudHttpAssetsChangeValue: Represents a field value in asset history (before/after change)
      - `value` unknown
  - `occurredAt` string, date-time, required: When the event occurred
  - `actor` JumpcloudHttpAssetsActor, required: Represents who performed an action on an asset
    - `id` string: The actor's unique identifier
    - `name` string, required: The actor's name
    - `type` 'ACTOR_TYPE_USER' | 'ACTOR_TYPE_SYSTEM' | 'ACTOR_TYPE_SERVICE_ACCOUNT' | 'ACTOR_TYPE_SYSTEM_USER', required: The type of actor
  - `actionSource` 'ACTION_SOURCE_MANUAL' | 'ACTION_SOURCE_SYSTEM' | 'ACTION_SOURCE_IMPORT' | 'ACTION_SOURCE_API', required: Source of the action

## Other responses

- `400`: Bad request - invalid data
- `401`: Unauthorized - authentication required
- `404`: Accessory asset not found
- `default`: Generic error response

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)