Elimina una Build de Applivery de forma permanente. Esta acción elimina el registro de la Build y su archivo asociado del almacenamiento.
Esta operación es permanente e irreversible. Una vez eliminada una Build, no puede recuperarse. Cualquier Publicación que apunte exclusivamente a esta Build dejará de poder servir la App para su descarga. Verifica que la Build no esté en uso en ninguna Publicación antes de eliminarla.
Applivery proporciona dos APIs independientes para eliminar Builds, cada una con una credencial de autenticación diferente.
Cómo elegir la API correcta
| Integrations API | Workspace API | |
|---|---|---|
| Diseñada para | Integraciones por app y pipelines de limpieza de CI/CD | Automatización a nivel de Workspace en varias Apps |
| Autenticación | App API Token (por app) | token de una cuenta de servicio (a nivel de Workspace) |
| Contexto de app | Implícito — el token ya está vinculado a una App | Explícito — se requieren organizationId y applicationId en la ruta |
| Usuarios típicos | Scripts de CI que eliminan Builds antiguos o fallidos automáticamente | Platform engineers que gestionan la retención de builds en varias Apps |
El acceso a las distintas APIs puede no estar disponible en tu plan actual. Consulta la disponibilidad en nuestra página de precios.
Integrations API
Usa este endpoint para eliminar Builds dentro del ámbito de una sola app. La autenticación usa un App API Token, vinculado a la App específica.
Para crear un App API Token, consulta Autenticación de la API de Apps.
Endpoint
DELETE https://api.applivery.io/v1/integrations/builds/{buildId}
Autenticación
Authorization: Bearer <your_app_token>
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
buildId |
String | Sí | El identificador único de la Build a eliminar. P. ej. 552ae3cfcb5abfc58d733b81. El buildId se devuelve en la respuesta de POST – Subir una Build y GET – Lista de Builds. |
Ejemplo de petición
curl 'https://api.applivery.io/v1/integrations/builds/552ae3cfcb5abfc58d733b81' \
-X DELETE \
-H 'Authorization: Bearer YOUR_APP_TOKEN'
Respuestas
{
"status": true,
"data": {
"deleted": true
}
}
Build aún no procesado. Las Builds en estado pending o in_progress no pueden eliminarse. Espera a que finalice el procesamiento antes de intentar eliminarla.
{
"status": false,
"error": {
"code": 5014,
"message": "Build Not Processed"
}
}
{
"status": false,
"error": {
"code": 3002,
"message": "Token Expired"
}
}
{
"status": false,
"error": {
"code": 3001,
"message": "Entity not found"
}
}
Workspace API
Usa este endpoint para eliminar Builds a nivel de Workspace — por ejemplo, en pipelines de retención de builds que operan en varias Apps usando una sola credencial.
La autenticación usa un token de cuenta de servicio, con ámbito de Workspace y no vinculado a ninguna app individual. El contexto de la app y de la Build se proporcionan mediante parámetros de ruta.
Para crear un token de una cuenta de servicio, consulta Cuentas de servicio.
Endpoint
DELETE https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/builds/{buildId}
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
organizationId |
String | Sí | El identificador único de tu organización en Applivery. |
applicationId |
String | Sí | El identificador único de la App a la que pertenece la Build. |
buildId |
String | Sí | El identificador único de la Build a eliminar. |
Autenticación
Authorization: Bearer <your_service_account_token>
Ejemplo de petición
curl 'https://api.applivery.io/v1/organizations/ORG_ID/apps/APP_ID/builds/552ae3cfcb5abfc58d733b81' \
-X DELETE \
-H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN'
El esquema de la respuesta es idéntico al de la Integrations API. Una eliminación correcta devuelve { "status": true, "data": { "deleted": true } }.