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

# Obtener las reglas de carpeta y su ETag

> Devuelve las reglas de carpeta de la cuenta y el etag que debes enviar de vuelta al reemplazarlas.

Devuelve todas las reglas de carpeta de la cuenta y el `etag` de la lista. Lee la lista antes de cambiarla, y envía el
`etag` de vuelta en `If-Match` al [reemplazar todas las reglas](https://docs.vertracloud.app/es-es/api-reference/endpoint/blob/rules/replace.md).

**Ámbito:** `blob:read`.

**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 "https://blob.vertracloud.app/v1/rules" \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

### Respuesta

**response** `object`

La lista de reglas y su 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": [
      {
        "prefix": "tmp/",
        "delete_after_days": 30,
        "active_from": "2026-10-15T12:00:00.000Z",
        "created_at": "2026-10-14T12:00:00.000Z"
      }
    ],
    "etag": "v3"
  }
}
```

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