hosting

DELETE /v1/private-network/devices/{seatId}

Revoke a device.

Todos os endpoints de hosting

Autenticação

Envie uma chave de API como um token bearer. Este endpoint não especifica uma permissão específica na documentação, portanto, conceda à sua chave o mínimo necessário e verifique a resposta em vez de assumir.

Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.

Experimente

Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.

curl -X DELETE https://api.zinndigital.com/v1/private-network/devices/{seatId} \
  -H "Authorization: Bearer zdk_live_…"

Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API

Detalhes

Gated on `network.private.manage`. The row is kept, marked revoked, so the revocation can be evidenced later — a revocation nobody can point at is not much of a control. ⚠️ Access stops when the gateway next syncs its peer set, not at the instant this returns. The dashboard says so rather than implying otherwise. 404 rather than 403 for a device in another tenant — a 403 would confirm it exists.

Parâmetros

NomeTipoObrigatórioO que é
seatId (path)stringSim

Resposta

NomeTipoObrigatórioO que é
idstringSim
labelstringSimWhat the customer calls it — "Neil's MacBook".
addressstringSimThe device's address inside the tunnel.
statusstring<active, revoked>Sim
created_atstringSim
revoked_atstringNão
last_seen_atstringNãoLast handshake the gateway reported. Null until the device first connects, which is what makes "you are paying for five devices and three have never been used" answerable.

Erros que este endpoint pode retornar

401 · 403 · 404