Definir vencimiento de assets de la organización
Set, renew or clear when assets drop off your organization’s allowlist. After the expiry passes, assets stay for a 14-day grace period, then are removed from your organization; their status does not change. Requires an organization API key with write access, or an organization owner or admin.
Descripción general
Define, renueva o borra la fecha en que los assets (Asset: activo digital, como una URL, dirección, perfil, app, etc.) salen de la Allowlist (lista de permitidos) de tu organización. Úsalo para assets que solo deben permanecer por un tiempo, como el sitio web de un socio. Cuando pasa el vencimiento de un asset, este sigue permitido y en tu organización durante un período de gracia de 14 días; después se quita de tu organización y se deja de monitorear. Su estado no cambia. Los propietarios y administradores de la organización reciben por correo electrónico un resumen diario de los próximos vencimientos y eliminaciones. Consulta Vencimiento para ver la línea de tiempo completa.- Definir una fecha en un asset vencido lo renueva y pone fin a su período de gracia.
- Pasar
nullborra el vencimiento, así que los assets permanecen indefinidamente. - La solicitud es todo o nada: si algún asset no está en tu organización, no cambia nada.
Inicio rápido
Autenticación
Incluye tu clave de API en el encabezadoX-API-KEY:
slug; debes ser propietario o administrador de esa organización.
Solicitud de ejemplo
"expiresAt": null.
Cuerpo de la solicitud
Respuesta
Respuesta exitosa
Campos de la respuesta
allowlistExpiresAt de cada asset, y allowlistExpiredAt una vez que comenzó su período de gracia.
Respuestas de error
400 Bad Request
Se devuelve cuandoexpiresAt no está en el futuro o el cuerpo está mal formado:
401 Unauthorized
Se devuelve cuando no se pasa ningúnslug y las credenciales no están limitadas a una organización:
403 Forbidden
Se devuelve cuando la clave de API es de solo lectura, pertenece a una organización distinta de la indicada enslug, o el usuario no es propietario ni administrador de la organización.
404 Not Found
Se devuelve cuando alguno de los assets no está en tu organización. No se cambia nada:Casos de uso
Hacer que los assets de socios venzan después de un año
Desde la CLI o MCP
organization_assets_set_expiry.Autorizaciones
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.
Cuerpo
Set when organization assets expire
Sets, renews or clears the allowlist expiry of assets on your organization. Use it for assets that should only stay for a while, such as a partner's site. When the date passes, the assets stay on your organization for a 14-day grace period, then are removed from it. Their status does not change. Setting a new date on an expired asset renews it and ends its grace period.