> ## 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 un objeto blob por ID

> Devuelve un objeto blob por su ID, con su ruta, tamaño, visibilidad, URL pública, metadatos y caducidad.

Devuelve un objeto blob por su ID. Un ID de otra cuenta devuelve `BLOB_OBJECT_NOT_FOUND`, igual que un ID que no existe.

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

**object\_id** `string` *required*

El ID del objeto devuelto al crearlo.

**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/objects/0b6f7c1e-3d2a-4f5b-9a8c-1d2e3f4a5b6c" \
  -H "Authorization: Bearer $VERTRA_API_KEY"
```

### Respuesta

**response** `object`

El objeto blob.

**propiedades**

**id** `string`

ID estable del objeto. Nunca cambia, aunque cambien la ruta, la visibilidad o la caducidad.

**path** `string`

Ruta completa dentro de la cuenta, por ejemplo `images/avatars/joao.png`.

**size** `number`

Tamaño en bytes.

**content\_type** `string`

Tipo MIME, derivado en el servidor a partir de la extensión del archivo.

**etag** `string`

Etiqueta de entidad del contenido almacenado.

**sha256** `string | null`

SHA-256 del contenido en hexadecimal, cuando la subida envió un checksum. `null` en otro caso.

**visibility** `string`

`public` (se puede leer mediante su URL pública) o `private` (necesita un enlace temporal o un enlace para compartir).

**url** `string | null`

URL pública. `null` mientras el objeto sea privado.

**cache\_control** `string | null`

`immutable`, `max-age=<seconds>` o `no-cache` (`no-cache` requiere Enterprise-26 o superior). `null` significa el valor por defecto.

**content\_disposition** `string`

`inline` (lo muestra el navegador) o `attachment` (se descarga). HTML, SVG y XML siempre son `attachment`.

**filename** `string | null`

Nombre sugerido al descargar. `null` usa el último segmento de `path`.

**metadata** `object`

Hasta 5 claves, cada una `[a-z0-9-]{1,64}`, 512 bytes en total. Enterprise-12 o superior; `{}` en otros planes.

**expires\_at** `string | null`

Cuándo se elimina el objeto, como marca de tiempo ISO 8601. `null` significa que no caduca.

**created\_at** `string`

Fecha de creación en ISO 8601.

**updated\_at** `string`

Fecha en ISO 8601 del último cambio.

```json Response theme={null}
{
  "response": {
    "id": "0b6f7c1e-3d2a-4f5b-9a8c-1d2e3f4a5b6c",
    "path": "images/logo.png",
    "size": 48213,
    "content_type": "image/png",
    "etag": "9b2cf535f27731c974343645a3085d39",
    "sha256": null,
    "visibility": "public",
    "url": "https://blob.vertracloud.dev/k7p2m9x4qa/images/logo.png",
    "cache_control": null,
    "content_disposition": "inline",
    "filename": null,
    "metadata": {},
    "expires_at": null,
    "created_at": "2026-10-14T12:00:00.000Z",
    "updated_at": "2026-10-14T12:00:00.000Z"
  }
}
```

### 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.
* `BLOB_OBJECT_NOT_FOUND` (`404`): No existe ningún objeto con ese ID en esta cuenta (o en el blob del workspace).

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