# Editar (/docs/developers/api-reference/legal-entities/edit)

## Descripcion general [#descripcion-general]

Este endpoint permite actualizar parcialmente una razón social. Todos los campos del cuerpo son **opcionales**: si omites una clave, ese campo no se toca. El identificador en la URL es el `legal_entity_number` dentro de tu organización. Una solicitud exitosa devuelve `200` con la forma completa de la razón social actualizada.

Las razones sociales eliminadas se tratan como no encontradas (`404`).

`is_active` **no** elimina la razón social: solo la marca como inactiva, y sigue apareciendo en `GET` (salvo que filtres con `active=false`). **Desactivarla (`is_active: false`) se rechaza con `409`** si algún empleo (de cualquier estatus) la referencia — reasigna esos empleos primero. Para hacer un borrado real, usa [DELETE](/docs/developers/api-reference/legal-entities/delete).

## Endpoint [#endpoint]

`PATCH https://app.integranom.com/api/v1/legal-entities/{legal_entity_number}`

**Path param:** `legal_entity_number` — entero positivo. Cualquier otro valor responde con `400`.

## Renombrar [#renombrar]

***

Envía solo los campos que quieras cambiar. El resto de la razón social queda intacta.

```json
{ "name": "Acme Holdings S.A. de C.V." }
```

**cURL**

```bash
curl -X PATCH "https://app.integranom.com/api/v1/legal-entities/7" \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Acme Holdings S.A. de C.V." }'
```

**Respuesta**

```json
{
"legal_entity_number": 7,
"name": "Acme Holdings S.A. de C.V.",
"is_active": true,
"created_at": "2026-05-25T10:00:00.000Z",
"updated_at": "2026-05-25T14:30:00.000Z"
}
```

## Marcar como inactiva [#marcar-como-inactiva]

***

Cambiar `is_active` a `false` marca la razón social como inactiva, pero **no** la elimina: sigue apareciendo en `GET /api/v1/legal-entities` (salvo que filtres por `active=true`) y puede reactivarse después. **La desactivación se rechaza con `409`** si algún empleo (cualquier estatus, incluidos los dados de baja) referencia la razón social — primero reasígnalos. Para retirarla por completo, usa [DELETE](/docs/developers/api-reference/legal-entities/delete).

```json
{ "is_active": false }
```

**cURL**

```bash
curl -X PATCH "https://app.integranom.com/api/v1/legal-entities/7" \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "is_active": false }'
```

**Respuesta**

```json
{
"legal_entity_number": 7,
"name": "Acme Holdings S.A. de C.V.",
"is_active": false,
"created_at": "2026-05-25T10:00:00.000Z",
"updated_at": "2026-05-25T14:35:00.000Z"
}
```

## Campos del cuerpo [#campos-del-cuerpo]

| Campo       | Tipo    | Notas                                                                                                                                                                                            |
| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `name`      | string  | No vacío tras recortar cuando se envía.                                                                                                                                                          |
| `is_active` | boolean | Alternar este flag **no** elimina la razón social: solo la marca como inactiva. Ponerlo en `false` se rechaza con `409` si algún empleo referencia la razón social. Para borrarla, usa `DELETE`. |

## Forma de la respuesta [#forma-de-la-respuesta]

`200 OK` — misma forma que la respuesta de [crear](/docs/developers/api-reference/legal-entities/create) en modo single.

## Errores [#errores]

| Status | Causa                                                                                                                                                                                                                               |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | `legal_entity_number` inválido en la URL (no es entero positivo); cuerpo JSON inválido; falla de validación de esquema.                                                                                                             |
| `404`  | La razón social no existe (o fue eliminada) en esta organización. Cuerpo: `{ "message": "Legal entity not found." }`.                                                                                                               |
| `409`  | Intento de desactivar (`is_active: false`) una razón social referenciada por uno o más empleos. Cuerpo: `{ "message": "This legal entity is still referenced by one or more employments. Reassign them before deactivating it." }`. |
| `500`  | Error no manejado. Cuerpo: `{ "message": "Internal Server Error" }`.                                                                                                                                                                |