# Models

## Introduction 

This API enables the provisioning and management of hardware models that are utilized to associate with the entities within an organizational structure. 

## Comprehensive API actions

### Reading a model

It is possible that entities may contain references to models that were previously manufactured by a now-deleted manufacturer. Consequently, deleting the manufacturer may result in a new discrepancy between its information and that of the entities. The `updateDevices` parameter allows the user to choose whether this action should be reflected or not. However, this only affects the manufacturer's information; models remain unaffected.

### Deleting a model

It is possible that entities may contain references to models that were previously manufactured by a now-deleted manufacturer. Consequently, deleting the manufacturer may result in a new discrepancy between its information and that of the entities. The `updateDevices` parameter allows the user to choose whether this action should be reflected or not. However, this only affects the manufacturer's information; models remain unaffected.

## API specification

{{< openapi  src="organization_models.yaml" >}}