Atualizar empreendimento - Homfy Public API

Altera um empreendimento pelo partner_code. Só o que vier no corpo é alterado; campo ausente fica como está. O partner_code em si não muda — não há como renomear o código.

Adotar um empreendimento que já existe. Mandando realty_cluster_id junto do partner_code, o empreendimento apontado passa a responder pelo seu código. É o caminho para quando a imobiliária já tinha o empreendimento cadastrado no painel, com imóveis ligados a ele: sem isso, cadastrar o mesmo empreendimento pela API criaria um SEGUNDO, e os imóveis antigos continuariam no primeiro. Só funciona em empreendimento sem código de parceiro; um que já tem código é recusado com PARTNER_REALTY_CLUSTER_ALREADY_ADOPTED, e nada é alterado.

address é substituído por inteiro, não mesclado campo a campo: mande o endereço completo. Se o empreendimento ainda não tinha endereço, é aqui que o code da Homfy nasce; se já tinha, o code NÃO muda, mesmo trocando a UF.

A resposta é o empreendimento como ele ficou — o mesmo corpo de POST /partner/v1/realty-cluster/find.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "partner_code": "EMP-1024",
    "type": "Empreendimento",
    "realty_cluster_id": 42,
    "name": "Residencial Bela Vista",
    "is_active": true,
    "description": "Condomínio fechado com 4 torres, entregue em 2019.",
    "email": "contato@belavista.com.br",
    "phone": "(48) 3333-4444",
    "whatsapp": "48999998888",
    "address": {
        "state": "SC",
        "zipcode": "88015-600",
        "city": "Florianópolis",
        "district": "Centro",
        "street": "Bocaiúva",
        "street_number": "120",
        "street_type": "Rua",
        "reference": "Próximo ao mercado",
        "complement": "Apto 302",
        "block": "Torre B",
        "latitude": "-27.593500",
        "longitude": "-48.548500"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

O empreendimento como ficou.

Bodyapplication/json

Example

{
    "partner_code": "AP-1024",
    "realty_cluster_id": 42,
    "code": "SC1547",
    "name": "Ana Corretora",
    "email": "ana@imobiliaria.com.br",
    "whatsapp": "48999998888",
    "created_at": "2026-08-19T20:33:39.719Z",
    "updated_at": "2026-08-19T20:33:39.719Z",
    "type": "string",
    "is_active": true,
    "description": "string",
    "phone": "string",
    "address": {
        "zipcode": "string",
        "state": "string",
        "city": "string",
        "district": "string",
        "street": "string",
        "street_number": "string",
        "street_type": "string",
        "reference": "string",
        "complement": "string",
        "block": "string",
        "latitude": "string",
        "longitude": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500