# Eliminar Build

> Elimina Builds de forma permanente de Applivery usando la Integrations API o la Workspace API. Cubre autenticación y parámetros.

Source: https://docs.applivery.com/es/app-distribution/api/builds/delete-build/  •  Last updated: 2026-06-08

**Answers:** ¿Qué ocurre al eliminar una Build en Applivery? · ¿Cuáles son las dos APIs de Applivery para eliminar builds? · ¿Cuándo debo usar la Integrations API para eliminar una Build? · ¿Cómo me autentico con la Integrations API para eliminar una Build? · ¿Cuándo debo usar la Workspace API para eliminar una Build? · ¿Qué parámetros requiere la Workspace API para eliminar una Build? · ¿Qué código de estado indica una eliminación correcta? · ¿Qué error aparece si intento eliminar una Build que aún se está procesando?

---

**TL;DR:** Elimina builds de Applivery de forma permanente usando la API de Integraciones (App API Token) o la API de Workspace (Cuenta de servicio).

Elimina una Build de Applivery de forma permanente. Esta acción elimina el registro de la Build y su archivo asociado del almacenamiento.

:::warning
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 |

:::warning
El acceso a las distintas APIs puede no estar disponible en tu plan actual. Consulta la disponibilidad en nuestra [página de precios](https://www.applivery.com/app-distribution-pricing/).
:::

---

## 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](https://docs.applivery.com/en/app-distribution/api/app-api-token/).

### 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](https://docs.applivery.com/en/app-distribution/api/builds/upload-build/) y [GET – Lista de Builds](https://docs.applivery.com/en/app-distribution/api/builds/list-builds/). |

### Ejemplo de petición

```bash
curl 'https://api.applivery.io/v1/integrations/builds/552ae3cfcb5abfc58d733b81' \
  -X DELETE \
  -H 'Authorization: Bearer YOUR_APP_TOKEN'
```

### Respuestas

**✓ 200 OK**

```json
{
  "status": true,
  "data": {
    "deleted": true
  }
}
```

**✗ 400 Bad Request**

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.

```json
{
  "status": false,
  "error": {
    "code": 5014,
    "message": "Build Not Processed"
  }
}
```

**✗ 401 Unauthorized**

```json
{
  "status": false,
  "error": {
    "code": 3002,
    "message": "Token Expired"
  }
}
```

**✗ 404 Not Found**

```json
{
  "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](https://docs.applivery.com/en/platform/api/service-accounts/).

### 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

```bash
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 } }`.