---
sourceDocument: Yokohama Operational Technology Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/operational-technology

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Operational Technology Management

ft:clusterId :

    - optm

bundleId :

    - optm

workflow :

    - Technology


---

# APIs for IT to OT and OT to IT conversion

# APIs for IT to OT and OT to IT conversion {#ariaid-title1}

Release version: Yokohama  
Updated January 30, 2025  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
There are 2 APIs used for handling refresh workflow scenarios for converting IT to Operational Technology (OT) and vice versa with the OT Asset Management application.

## APIs used in OT Asset Management {#api-for-it-to-ot-and-ot-to-it-conversion__section_trb_b25_wdc}

With OT Asset Management, you need to maintain synchronization between asset and configuration item (CI) for OT assets. The following APIs are used for IT to OT conversion and OT to IT conversion in the OT Asset Management application.  
Note:  
The IT CI class isn't changed. Instead an OT entity record is added, which provides the OT device context.

* Convert IT to OT Asset API
* Convert OT to IT Asset API
{#api-for-it-to-ot-and-ot-to-it-conversion__ul_jdm_g35_wdc}  
Convert IT to OT Asset API

The Convert IT to OT Asset API is used in refresh workflows where an OT configuration item (CI) is replaced with a new CI. This API creates a replica of the previous OT entity record, and maps them to the new CI. No changes occur
in the previous CI and its related OT entity record. Both the new CI and the previous CI references are used with this API.  
Convert OT to IT Asset API

The Convert OT to IT Asset API is used if an asset needs to be replaced. The API deletes the OT entity record of the passed CI.

For more information about Asset and
Configuration Item (CI) synchronization for Operational Technology (OT) assets, see [Asset and Configuration Item (CI) synchronization for Operational Technology (OT) assets](https://www.servicenow.com/docs/access?context=asset-ci-sync-ot-assets&version=yokohama&pubname=yokohama-it-asset-management&ft:locale=en-US).

For more information about OT Asset Management, see [OT Asset Management](https://www.servicenow.com/docs/access?context=ot-asset-management&version=yokohama&pubname=yokohama-it-asset-management&ft:locale=en-US).