> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bold-factory.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizaciones parciales con PATCH

> Cambia solo los campos que envías con PATCH y conserva el resto del recurso tal como está.

Las rutas de edición que usan `PATCH` cambian solo los campos del cuerpo de la petición. Cada campo puede estar en uno de tres estados:

| Cuerpo | Resultado |
| - | - |
| El campo no aparece | El campo conserva su valor actual. |
| `"campo": null` | El campo se borra. Solo se pueden borrar los campos que admiten `null` en la referencia de la API. |
| `"campo": valor` | El campo toma el nuevo valor. |

Envía solo lo que quieras cambiar. Un campo que no conoces, o que añade una versión posterior de la API, nunca se sobrescribe.

## Cambiar un campo

Por ejemplo, para renombrar un equipo y conservar su código, sus datos, su activo padre y su titular:

```bash theme={null}
curl -X PATCH "https://api.bold-factory.com/v1/maintenance/assets/equipments/<asset-id>" \
  -H "X-Api-Key: $BOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Prensa 2" }'
```

## Borrar un campo

Envía `null` para quitar un valor. Esta petición quita el titular del equipo y deja el resto de campos como estaban:

```bash theme={null}
curl -X PATCH "https://api.bold-factory.com/v1/maintenance/assets/equipments/<asset-id>" \
  -H "X-Api-Key: $BOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "holderId": null }'
```

Enviar `null` en un campo que no se puede borrar, como `name`, devuelve `400 Bad Request`.

> [!WARNING]
>
> Algunos clientes HTTP y SDK generados omiten las propiedades cuyo valor es `null`. Comprueba que el tuyo envía el `null` cuando necesites borrar un campo; si no, el campo conserva su valor.

## Rutas que sustituyen el recurso completo

Algunas rutas de edición solo tienen `PUT`, que sustituye todos los campos editables: un campo que no envíes puede borrarse. Donde un recurso tiene las dos, el `PUT` sigue funcionando como hasta ahora. Antes de retirar un `PUT`, aparece como obsoleto en la [referencia de la API](https://docs.bold-factory.com/es/desarrolladores/referencia-api/introduccion.md) y sigue funcionando un tiempo, así que pasa tu integración a la ruta `PATCH` cuando exista.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.