Listar objetos blob de una carpeta
curl --request GET \
--url https://blob.vertracloud.app/v1/objects \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/objects', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/objects"
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"
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": {
"objects": [
{
"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"
}
],
"folders": [
"images/avatars/"
],
"cursor": null
}
}
Objetos
Listar objetos blob de una carpeta
Lista los objetos blob de la cuenta por prefijo de ruta, con carpetas y un cursor para la página siguiente. Devuelve hasta 1.000 objetos por llamada.
GET
/
v1
/
objects
Listar objetos blob de una carpeta
curl --request GET \
--url https://blob.vertracloud.app/v1/objects \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/objects', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/objects"
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"
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": {
"objects": [
{
"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"
}
],
"folders": [
"images/avatars/"
],
"cursor": null
}
}
Lista los objetos blob de la cuenta en orden de ruta. Usa
prefix para listar una carpeta y delimiter=/ para obtener sus
subcarpetas como folders. Pasa el cursor devuelto para obtener la página siguiente; cursor es null en la última
página.
Ámbito: blob:read.
string
Solo los objetos cuyo
path empiece por este texto, por ejemplo images/.string
Agrupa las rutas en carpetas en este carácter, normalmente
/. Las carpetas se devuelven en folders y no como objetos.string
Solo objetos
public o solo objetos private.string
El
cursor de la página anterior. Omítelo en la primera página.number
Objetos por página, de 1 a 1000. Por defecto
100.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?prefix=images/&delimiter=/&limit=100" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object
La página de objetos, sus subcarpetas y el cursor de la página siguiente.
Mostrar propiedades
Mostrar propiedades
object[]
Objetos de esta página. Cada elemento tiene los campos de Obtener un objeto blob.
string
ID estable del objeto.
string
Ruta completa dentro de la cuenta.
number
Tamaño en bytes.
string
public o private.string | null
URL pública, o
null mientras sea privado.string[]
Prefijos de carpeta que terminan en
/. Vacío sin delimiter.string | null
Envíalo de vuelta como
cursor para obtener la página siguiente. null en la última página.{
"response": {
"objects": [
{
"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"
}
],
"folders": [
"images/avatars/"
],
"cursor": null
}
}
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.VALIDATION_ERROR(400): Un parámetro no superó la validación, ydetails.pathlo indica. Uncursormal formado, o uno de otra consulta, devuelve este error condetails.pathencursor.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
{
"code": "VALIDATION_ERROR"
}
Última modificación el 28 de octubre de 2026