Saltar al contenido principal
DELETE
Remove asset from organization

Descripción general

Quita un Asset (activo digital: URL, dirección, perfil, app, etc.) de la Allowlist (lista de permitidos) de tu organización. Esta operación elimina la asociación entre el asset y tu organización: el asset en sí permanece en el sistema de ChainPatrol, pero ya no está vinculado a tu organización. El asset debe pertenecer a tu organización para poder quitarlo.

Inicio rápido

Autenticación

Incluye tu clave de API en el encabezado X-API-KEY:

Solicitud de ejemplo

Parámetros de ruta

Cuerpo de la solicitud

Respuesta

Respuesta exitosa

Campos de la respuesta

Respuestas de error

400 Bad Request

Se devuelve cuando la solicitud está mal formada:

401 Unauthorized

Se devuelve cuando falta la clave de API, no es válida o no tiene acceso a la organización:

403 Forbidden

Se devuelve cuando el asset no pertenece a tu organización:

404 Not Found

Se devuelve cuando el asset no existe o ya se había quitado de tu organización:

Buenas prácticas

Verificación antes de quitar

Verifica siempre el asset antes de quitarlo para evitar operaciones accidentales:

Eliminación masiva

Cuando quites varios assets de tu organización, procésalos de forma secuencial y con manejo de errores:

Registro de auditoría

Implementa un registro de las operaciones de eliminación con fines de cumplimiento y depuración:

Casos de uso

Quitar assets desactualizados

Quitar assets por grupo

Eliminación interactiva con confirmación

Notas

  • Esta operación elimina la asociación entre el asset y tu organización: el asset en sí permanece en el sistema de ChainPatrol
  • Después de quitarlo, el asset ya no aparecerá en las listas de assets de tu organización
  • Solo se pueden quitar los assets que pertenecen a tu organización
  • La organización se determina automáticamente a partir de tu clave de API
  • El ID del asset debe coincidir tanto en la ruta de la URL como en el cuerpo de la solicitud
  • Si lo necesitas, más adelante puedes volver a agregar el mismo asset a tu organización con el endpoint Agregar assets a la organización
  • Quitar un asset no afecta su existencia en la base de datos de ChainPatrol ni su estado para otras organizaciones

Autorizaciones

X-API-KEY
string
header
requerido

Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.

Parámetros de ruta

assetId
integer
requerido

ID of the asset to remove

Rango requerido: x > 0

Respuesta

Successful response

Delete operation result

success
boolean
requerido

Whether the asset was removed successfully

id
number
requerido

Asset ID that was removed