*API REST › Errores*

# `address_in_use`

> HTTP HTTP 409.

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

## Cuándo ocurre

409. [`DELETE /api/v1/contacts/{contactId}/addresses/{addressId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/remove-an-address-from-a-contact) rechazado porque un pedido usa la dirección como dirección de facturación o de envío. No se quita nada. La primera entrada de `errors` tiene `count`, el número de pedidos que la usan.

## Qué hacer

Modifica primero la dirección de esos pedidos y después elimina la dirección.

## 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` |
| `errors[].count` | integer | En `contact_in_use` y `address_in_use`: cuántos registros del tipo indicado por `path` lo usan. |

## Ejemplo

*address_in_use*

```json
{
  "type": "https://docs.filmo.io/errors/address_in_use",
  "title": "Address in use",
  "status": 409,
  "code": "address_in_use",
  "detail": "The address is the billing or shipping address of 2 orders: change it on them before deleting it",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c",
  "errors": [
    {
      "path": "orders",
      "code": "in_use",
      "message": "Used by 2 records of this type",
      "count": 2
    }
  ]
}
```

## Lo devuelven

- [`DELETE /api/v1/contacts/{contactId}/addresses/{addressId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/remove-an-address-from-a-contact) — Quitar una dirección de 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/address_in_use  
Última actualización: 2026-10-25