*API REST › Errores*

# `contact_in_use`

> HTTP HTTP 409.

Estado HTTP: `409` · Tipo del problema: `https://docs.filmo.io/errors/contact_in_use`

## Cuándo ocurre

409. [`DELETE /api/v1/contacts/{contactId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/delete-a-contact) rechazado porque algo todavía usa el contacto (pedidos, proyectos, presupuestos, facturas y otros documentos). No se elimina nada. `errors` tiene una entrada por cada tipo de registro que lo usa: `path` nombra el tipo y `count` indica cuántos hay.

## Qué hacer

Lee `errors[]` y mueve o quita antes esos registros. Si solo quieres que el contacto deje de verse, archívalo actualizándolo con `status: archived`; la eliminación no se puede deshacer.

## Reintento

| Condición | Qué hacer | Nota |
| --- | --- | --- |
| 409 contact_in_use · address_in_use · insufficient_stock | Corregir y reenviar | No reintentes. `errors[]` dice qué bloquea la operación: corrígelo primero. |

## Campos de errors[]

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `errors[].path` | string | Ruta del campo erróneo en notación de puntos y corchetes (`lines[0].itemId`); vacía si afecta a todo el cuerpo. En `contact_in_use`, `address_in_use` e `insufficient_stock` es uno de un conjunto cerrado, listado por código en `x-path-values`: el tipo de registro que usa el contacto o la dirección, o la clase de recurso que escasea (`items` o `spaces`). `orders`, `projects`, `quotes`, `invoices`, `proformas`, `creditNotes`, `simpleCreditNotes`, `salesReceipts`, `supplierInvoices`, `contracts`, `subrents`, `purchaseOrders`, `sepaMandates`, `receipts`, `consignments` |
| `errors[].count` | integer | En `contact_in_use` y `address_in_use`: cuántos registros del tipo indicado por `path` lo usan. |

## Ejemplo

*contact_in_use*

```json
{
  "type": "https://docs.filmo.io/errors/contact_in_use",
  "title": "Contact in use",
  "status": 409,
  "code": "contact_in_use",
  "detail": "The contact is used by orders, projects, documents or payments and cannot be deleted: archive it instead (status: archived). The count per type is in errors",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "orders",
      "code": "in_use",
      "message": "Used by 3 records of this type",
      "count": 3
    },
    {
      "path": "quotes",
      "code": "in_use",
      "message": "Used by 1 record of this type",
      "count": 1
    }
  ]
}
```

## Lo devuelven

- [`DELETE /api/v1/contacts/{contactId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/delete-a-contact) — Eliminar un contacto

## Por MCP

Una llamada a una herramienta que falla vuelve con `isError` y el problema como contenido estructurado, con el mismo `code`.

---

URL canónica: https://docs.filmo.io/es/rest-api/errors/contact_in_use  
Última actualización: 2026-10-25