> For the complete documentation index, see [llms.txt](https://docs.hiboo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hiboo.io/rest-api-reference/fleet-identity/equipment-identity.md).

# Equipment Identity

The following endpoints allow you to manage the identity of your equipments, such as enterprise, year, model, and custom fields.

## Update Equipment Identity

> Update equipment data with assetId or (serialNumber AND make)

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Equipment Identity","description":"The following endpoints allow you to manage the identity of your equipments, such as enterprise, year, model, and custom fields."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"schemas":{"asset":{"type":"object","properties":{"assetId":{"type":"number"},"serialNumber":{"type":"string"},"make":{"type":"string"},"name":{"type":"string"},"category":{"type":"string","description":"The category must exist beforehand and will not be created if it does not exist"},"model":{"type":"string"},"entreprise":{"type":"string"},"year":{"oneOf":[{"type":"number"}]}}},"Error":{"required":["message","details"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"},"details":{"type":"object","description":"Additional information about the Error"}}},"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}},"responses":{"400Error":{"description":"Missing parameters or invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}}},"paths":{"/v2/fleet/equipment":{"patch":{"operationId":"updateFleetEquipment","summary":"Update Equipment Identity","description":"Update equipment data with assetId or (serialNumber AND make)","tags":["Equipment Identity"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asset"}}}},"responses":{"200":{"description":"Equipment has been modified","content":{"application/json":{"schema":{"properties":{"status":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/400Error"},"401":{"$ref":"#/components/responses/401Error"},"500":{"description":"An error occurred while processing the request","content":{"application/json":{"schema":{"properties":{"status":{"type":"string"}}}}}}}}}}}
```

## Add Custom Fields to Equipment

> add assetCustomFields data with assetId or (serialNumber AND make)

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Equipment Identity","description":"The following endpoints allow you to manage the identity of your equipments, such as enterprise, year, model, and custom fields."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"schemas":{"bodyAssetCustomFields":{"type":"object","properties":{"assetId":{"type":"number"},"serialNumber":{"type":"string"},"make":{"type":"string"},"customFields":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}}}},"Error":{"required":["message","details"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"},"details":{"type":"object","description":"Additional information about the Error"}}},"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}},"responses":{"400Error":{"description":"Missing parameters or invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}}},"paths":{"/v2/fleet/equipment/assetCustomFields":{"post":{"operationId":"addFleetEquipmentAssetCustomFields","summary":"Add Custom Fields to Equipment","description":"add assetCustomFields data with assetId or (serialNumber AND make)","tags":["Equipment Identity"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/bodyAssetCustomFields"}}}},"responses":{"200":{"description":"AssetCustomFields has been added","content":{"application/json":{"schema":{"properties":{"status":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/400Error"},"401":{"$ref":"#/components/responses/401Error"},"500":{"description":"An error occurred while processing the request","content":{"application/json":{"schema":{"properties":{"status":{"type":"string"}}}}}}}}}}}
```

## Remove Custom Fields from Equipment

> delete assetCustomFields data with assetId or (serialNumber AND make)

```json
{"openapi":"3.0.3","info":{"title":"Hiboo API","version":"2.0.0"},"tags":[{"name":"Equipment Identity","description":"The following endpoints allow you to manage the identity of your equipments, such as enterprise, year, model, and custom fields."}],"servers":[{"url":"https://api.hiboo.io","description":"Production server"},{"url":"https://api-sandbox.hiboo.io","description":"Sandbox server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"x-access-token","description":"Generate a JWT when you log in. Use it in your following requests in the header as `x-access-token: your-token-here`\n"}},"schemas":{"bodyAssetCustomFields":{"type":"object","properties":{"assetId":{"type":"number"},"serialNumber":{"type":"string"},"make":{"type":"string"},"customFields":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}}}},"Error":{"required":["message","details"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"},"details":{"type":"object","description":"Additional information about the Error"}}},"NoDetailError":{"required":["message"],"type":"object","properties":{"message":{"type":"string","description":"A human readable description of the error"}}}},"responses":{"400Error":{"description":"Missing parameters or invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401Error":{"description":"Unable to authenticate the token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoDetailError"}}}}}},"paths":{"/v2/fleet/equipment/assetCustomFields":{"delete":{"operationId":"deleteFleetEquipmentAssetCustomFields","summary":"Remove Custom Fields from Equipment","description":"delete assetCustomFields data with assetId or (serialNumber AND make)","tags":["Equipment Identity"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/bodyAssetCustomFields"}}}},"responses":{"200":{"description":"AssetCustomFields has been deleted","content":{"application/json":{"schema":{"properties":{"status":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/400Error"},"401":{"$ref":"#/components/responses/401Error"},"500":{"description":"An error occurred while processing the request","content":{"application/json":{"schema":{"properties":{"status":{"type":"string"}}}}}}}}}}}
```