Saltar al contenido principal
POST
Set organization asset expiry

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 null borra 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 encabezado X-API-KEY:
Una clave de API de organización necesita acceso de lectura y escritura. Con credenciales de usuario, pasa slug; debes ser propietario o administrador de esa organización.

Solicitud de ejemplo

Para borrar el vencimiento, envía "expiresAt": null.

Cuerpo de la solicitud

Respuesta

Respuesta exitosa

Campos de la respuesta

La respuesta de Listar assets de la organización muestra el allowlistExpiresAt de cada asset, y allowlistExpiredAt una vez que comenzó su período de gracia.

Respuestas de error

400 Bad Request

Se devuelve cuando expiresAt no está en el futuro o el cuerpo está mal formado:

401 Unauthorized

Se devuelve cuando no se pasa ningún slug 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 en slug, 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

El servidor MCP expone la misma operación como la herramienta organization_assets_set_expiry.

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.

Cuerpo

application/json

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.

assetIds
integer[]
requerido

IDs of the organization's assets to update (max 5000 per request)

Required array length: 1 - 5000 elements
Rango requerido: x > 0
expiresAt
string<date-time> | null
requerido

When the assets expire, as an ISO 8601 date-time in the future (e.g. 2027-04-30T23:59:59Z). null clears the expiry so the assets stay indefinitely.

slug
string

Organization slug. Optional for organization-scoped API keys, which resolve the organization from the key itself. Required when your credentials can reach more than one organization.

Respuesta

Successful response

Expiry update result

updatedCount
number
requerido

Number of assets updated

expiresAt
string | null
requerido

The expiry that was set, or null when it was cleared