Errors

`address_in_use`

HTTP HTTP 409.

HTTP status: 409
Problem type: https://docs.filmo.io/errors/address_in_use

{
  "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
    }
  ]
}

When it happens

409. DELETE /api/v1/contacts/{contactId}/addresses/{addressId} refused because an order uses the address as its billing or shipping address. Nothing is removed. The first entry of errors has count, the number of orders that use it.

What to do

Change the address on those orders first, then delete the address.

Retry

Fix and resend409 contact_in_use · address_in_use · insufficient_stock
Do not retry. errors[] says what blocks the operation: fix that first.

Fields of errors[]

errors[].pathstring

Path of the offending field in dot and bracket notation (lines[0].itemId); empty for the whole body. On contact_in_use, address_in_use and insufficient_stock it is one of a closed set, listed by code in x-path-values: the type of record that uses the contact or the address, or the kind of resource that is short (items or spaces).

Available options: orders

errors[].countinteger

On contact_in_use and address_in_use: how many records of the type named by path use it.

Returned by

1 operations

DELETE /api/v1/contacts/{contactId}/addresses/{addressId} — Remove an address from a contact

Through MCP

A tool call that fails comes back with `isError` set and the problem as structured content, with the same `code`.

Was this page helpful?

Example