Saltar al contenido principal
DELETE
Delete asset group

Descripción general

Elimina un grupo de Assets (activos digitales: URL, direcciones, perfiles, apps, etc.) de tu organización. Cuando se elimina un grupo, todos los assets asignados a ese grupo quedan sin grupo. Los assets en sí no se eliminan: solo se quita su asignación al grupo.

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 tiene un formato incorrecto:

401 Unauthorized

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

403 Forbidden

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

404 Not Found

Se devuelve cuando el grupo no existe o ya fue eliminado:

Buenas prácticas

Confirma antes de eliminar

Confirma siempre antes de eliminar un grupo, sobre todo si contiene assets:

Reasigna los assets antes de eliminar

Mueve los assets a otro grupo antes de eliminar:

Eliminación masiva con filtros

Elimina varios grupos según ciertos criterios:

Registro de auditoría

Registra las eliminaciones de grupos con fines de cumplimiento:

Casos de uso

Limpiar grupos sin uso

Elimina los grupos que no se han usado desde hace tiempo:

Consolidar grupos

Elimina grupos antiguos y fusiona sus assets en un grupo nuevo:

Eliminación interactiva

Ofrece una interfaz interactiva para eliminar grupos:

Mensajes de error comunes

Notas

  • Eliminar un grupo no elimina los assets: quedan sin grupo
  • El campo unassignedAssetCount de la respuesta muestra cuántos assets se vieron afectados
  • La organización se determina automáticamente a partir de tu clave de API
  • El ID del grupo debe coincidir en la ruta de la URL y en el cuerpo de la solicitud
  • Los grupos vacíos (con 0 assets) se pueden eliminar de forma segura, sin efectos secundarios
  • Esta operación no se puede deshacer: considera exportar los datos del grupo antes de eliminarlo
  • Los assets sin grupo se pueden reasignar a grupos en cualquier momento con el endpoint de actualización de assets

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

groupId
integer
requerido

ID of the group to delete

Rango requerido: x > 0

Respuesta

Successful response

Delete operation result

success
boolean
requerido

Whether the group was deleted successfully

id
number
requerido

Group ID that was deleted

unassignedAssetCount
number
requerido

Number of assets that were unassigned from this group