Atualizar ativo financeiro

PATCH

/assets/fiancial/{fiancialId}

Altera o ativo financeiro informado em fiancialId (o caminho é /assets/fiancial/, e essa é a grafia que a API atende). São obrigatórios type, description e value (número maior ou igual a zero); year (ano de referência) é opcional e, omitido, mantém o valor atual. situationAt (histórico de valores, com data e valor) também é opcional, mas, se omitido, o histórico é apagado. Devolve o ativo atualizado. Ativo inexistente ou removido devolve 404; 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

Ativo financeiro atualizado

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠404Ativo financeiro não encontrado

🟠422Dados do ativo inválidos

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/assets/fiancial/f1a2b3c4-0000-4000-8000-000000000401' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "type": "aplicacao",
    "description": "CDB Banco Exemplo",
    "value": 350000,
    "year": "2026",
    "situationAt": [
        {
            "data": "2025-12-31",
            "value": 320000
        }
    ]
}'

Response Example

200 - Sucesso

{
    "clientId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "type": "aplicacao",
    "description": "CDB Banco Exemplo",
    "situationAt": [
        {
            "data": "2025-12-31",
            "value": 320000
        }
    ],
    "value": 350000,
    "year": "2026",
    "updatedAt": "2026-10-01T12:00:00.000Z"
}

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

Página anterior

Remover imóvel urbano

Próxima página

Remover ativo financeiro