> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Eliminar una regla de carpeta

> Elimina la regla de un prefijo de carpeta y devuelve las reglas restantes con el nuevo etag.

Elimina la regla de un prefijo de carpeta. Los objetos que ya están guardados en la carpeta no cambian. La respuesta es la
lista restante con su nuevo `etag`. Eliminar una regla que no existe no es un error: responde `200` con la lista actual,
así que la llamada se puede repetir sin problema.

**Ámbito:** `blob:write`.

**prefix** `string` *required*

Prefijo de carpeta, codificado en URL.

**workspace\_id** `string`

El ID del workspace, cuando el blob pertenece a un workspace. La petición actúa sobre el blob del propietario del
workspace y necesita el permiso `blob:read` del workspace (`blob:manage` en las rutas que modifican datos). Omítelo
para actuar sobre tu propio blob.

### Ejemplo de petición

```bash theme={null}
curl -X DELETE "https://blob.vertracloud.app/v1/rules/tmp%2F" \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

### Respuesta

**response** `object`

Las reglas restantes y su nuevo etag.

**propiedades**

**rules** `object[]`

Reglas de carpeta. Se aplica el prefijo coincidente más largo.

**rules\[].prefix** `string`

Prefijo de carpeta, que siempre se guarda con `/` al final.

**rules\[].visibility** `string`

Visibilidad por defecto de los objetos nuevos de la carpeta.

**rules\[].expire\_seconds** `number`

Caducidad por defecto de cada objeto nuevo, en segundos.

**rules\[].max\_size** `number`

Archivo aceptado más grande, en bytes, de 512 B a 10 GB.

**rules\[].extensions** `string[]`

Extensiones aceptadas, de 1 a 50, en minúsculas, sin el punto.

**rules\[].cache\_control** `string`

`cache_control` por defecto de los objetos nuevos.

**rules\[].delete\_after\_days** `number`

Los objetos se eliminan estos días después de subirlos, de 1 a 3650.

**rules\[].active\_from** `string`

Cuándo empieza a aplicarse `delete_after_days`, lo fija la plataforma (24 horas después de guardar la regla).

**rules\[].created\_at** `string`

Fecha ISO 8601 de creación de la regla.

**etag** `string`

Versión de la lista completa de reglas. Envíala de vuelta en `If-Match` cuando reemplaces la lista.

```json Response theme={null}
{
  "response": {
    "rules": [],
    "etag": "v4"
  }
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING` (`401`): No se envió la cabecera `Authorization`.
* `API_KEY_INVALID` (`401`): La clave de API no existe, fue revocada o su secreto no coincide.
* `API_KEY_SCOPE_DENIED` (`403`): La clave no tiene el ámbito que necesita esta ruta (`blob:read` o `blob:write`); `details.required` lo indica.
* `WORKSPACE_PERMISSION_DENIED` (`403`): Solo con `workspace_id`: no eres miembro, o tu rol no tiene el permiso de blob.
* `WORKSPACE_NOT_FOUND` (`404`): Solo con `workspace_id`: no existe un workspace con ese ID, o no eres miembro.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```

```json Error Response (403) theme={null}
{
  "code": "API_KEY_SCOPE_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "WORKSPACE_NOT_FOUND"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.