Vincular/Desvincular equipamento

PATCH

/asset/update-device/{assetId}

Vincula ou desvincula um equipamento de um ativo.

Disponível para: Somente Revendedor
Rate limit: 100 requisições/minuto

Regras

Envie o deviceId para vincular.

Envie "deviceId": null para desvincular o equipamento atual.

deviceId: null, ou corpo vazio, desvincula. Equipamento já vinculado a outro ativo responde 422.

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 Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

🟠400Bad request

🟠403Forbidden

🟠404Registry not found

🟠422Unprocessable Entity

🟠429Too Many Request

🔴500Internal server error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.cloud-services.yuv.com.br/asset/update-device/100' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "deviceId": 321
}'

Response Example

200 - Vinculado

{
    "data": {
        "assetId": 1849,
        "deviceId": 321,
        "deviceImei": "864993060000000"
    }
}

Modificado em 2026-10-15 18:07:47

Vincular/Desvincular equipamento

Regras#

Requisição

Respostas

Regras