Atualizar imóvel urbano

PATCH

/assets/{id}/properties/urban/update

Substitui os dados do imóvel urbano informado em id. Todos os campos do cadastro são obrigatórios, mesmo os que não mudam: type, description, totalArea, value, state, county e year (ano com 4 dígitos). situationAt é opcional, mas, se omitido, o histórico de valores é apagado. description e county são gravados em letras maiúsculas. Imóveis removidos também podem ser alterados e continuam removidos. Devolve o imóvel atualizado. Imóvel inexistente devolve 400 (Imóvel não encontrado); tipo ou UF fora da lista também devolvem 400; corpo fora do formato devolve 422. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Imóvel urbano atualizado

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Imóvel não encontrado ou dados inválidos

🟠422Dados do imóvel inválidos

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/assets/f1a2b3c4-0000-4000-8000-000000000201/properties/urban/update' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "house",
    "description": "Casa sede na área urbana",
    "totalArea": 250,
    "value": 850000,
    "state": "MT",
    "county": "Sorriso",
    "year": "2026",
    "situationAt": [
        {
            "data": "2025-12-31",
            "value": 800000
        }
    ]
}'

Response Example

200 - Sucesso

{
    "id": "f1a2b3c4-0000-4000-8000-000000000201",
    "description": "CASA SEDE NA ÁREA URBANA",
    "totalArea": 250,
    "value": 850000,
    "type": "house",
    "state": "MT",
    "county": "SORRISO",
    "year": "2026",
    "situationAt": [
        {
            "data": "2025-12-31",
            "value": 800000
        }
    ]
}

Modificado em 2026-10-13 09:47:06

Página anterior

Cadastrar imóvel urbano de um cliente

Próxima página

Remover imóvel urbano