Obtener un objeto blob por ID
curl --request GET \
--url https://blob.vertracloud.app/v1/objects/{object_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/objects/{object_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/objects/{object_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/objects/{object_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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"
}
}
Objetos
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.
GET
/
v1
/
objects
/
{object_id}
Obtener un objeto blob por ID
curl --request GET \
--url https://blob.vertracloud.app/v1/objects/{object_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/objects/{object_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/objects/{object_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/objects/{object_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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"
}
}
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.
string
requerido
El ID del objeto devuelto al crearlo.
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
curl "https://blob.vertracloud.app/v1/objects/0b6f7c1e-3d2a-4f5b-9a8c-1d2e3f4a5b6c" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object
El objeto blob.
Mostrar propiedades
Mostrar propiedades
string
ID estable del objeto. Nunca cambia, aunque cambien la ruta, la visibilidad o la caducidad.
string
Ruta completa dentro de la cuenta, por ejemplo
images/avatars/joao.png.number
Tamaño en bytes.
string
Tipo MIME, derivado en el servidor a partir de la extensión del archivo.
string
Etiqueta de entidad del contenido almacenado.
string | null
SHA-256 del contenido en hexadecimal, cuando la subida envió un checksum.
null en otro caso.string
public (se puede leer mediante su URL pública) o private (necesita un enlace temporal o un enlace para compartir).string | null
URL pública.
null mientras el objeto sea privado.string | null
immutable, max-age=<seconds> o no-cache (no-cache requiere Enterprise-26 o superior). null significa el valor por defecto.string
inline (lo muestra el navegador) o attachment (se descarga). HTML, SVG y XML siempre son attachment.string | null
Nombre sugerido al descargar.
null usa el último segmento de path.object
Hasta 5 claves, cada una
[a-z0-9-]{1,64}, 512 bytes en total. Enterprise-12 o superior; {} en otros planes.string | null
Cuándo se elimina el objeto, como marca de tiempo ISO 8601.
null significa que no caduca.string
Fecha de creación en ISO 8601.
string
Fecha en ISO 8601 del último cambio.
{
"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
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING(401): No se envió la cabeceraAuthorization.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:readoblob:write);details.requiredlo indica.WORKSPACE_PERMISSION_DENIED(403): Solo conworkspace_id: no eres miembro, o tu rol no tiene el permiso de blob.WORKSPACE_NOT_FOUND(404): Solo conworkspace_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).
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
Última modificación el 28 de octubre de 2026