Contacts Tools

Delete Contact

Delete a contact identified by contact_code. If only a name, email, phone, CPF, or CNPJ is known, use search_contacts first to obtain the code required by the path. This action is irreversible and requires explicit user confirmation. Write operation: deletes a contact.

delete/v1/mcp/tool/contact/{contact_code}

Request

  • Base URL: https://api.imobzi.app
  • URL: https://api.imobzi.app/v1/mcp/tool/contact/{contact_code}
  • Auth: API key in header X-Imobzi-Secret

Path parameters

contact_codestring required

Public contact code placed in the request path. It is the primary selector and takes priority over email, name, phone, or CPF/CNPJ when it resolves to a contact. Preserve the code returned by search_contacts. The action is irreversible and requires explicit user confirmation.

Query parameters

contact_emailstring nullable

Fallback selector for the existing contact, used only when contact_code does not resolve. Exact email, case-insensitive.

contact_namestring nullable

Fallback selector for the existing contact, used only when contact_code does not resolve. It must identify exactly one person or organization.

contact_phonestring nullable

Fallback selector for the existing contact, used only when contact_code does not resolve. Formatting is ignored and the phone must contain at least eight digits.

contact_legal_identificationstring nullable

Fallback selector for the existing contact, used only when contact_code does not resolve. Accepts CPF or CNPJ with or without formatting.

Changes

No recorded changes to this operation across all 1 revision of this API.