Listar objetos de blob em uma pasta
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 de blob em uma pasta
Lista os objetos de blob da conta por prefixo de caminho, com as pastas e um cursor para a próxima página. Retorna até 1.000 objetos por chamada.
GET
/
v1
/
objects
Listar objetos de blob em uma pasta
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 os objetos de blob da conta na ordem dos caminhos. Use
prefix para listar uma pasta e delimiter=/ para receber as suas subpastas em folders. Envie o cursor retornado de volta para obter a próxima página; cursor é null na última página.
Escopo: blob:read.
string
Somente objetos cujo
path começa com este texto, por exemplo images/.string
Agrupa os caminhos em pastas neste caractere, geralmente
/. As pastas voltam em folders e não como objetos.string
Somente objetos
public ou somente objetos private.string
O
cursor da página anterior. Omita-o na primeira página.number
Objetos por página, de 1 a 1000. Padrão
100.string
O ID do workspace, quando o blob pertence a um workspace. A chamada atua sobre o blob do proprietário do workspace e exige a permissão
blob:read do workspace (blob:manage nas rotas que alteram dados). Deixe de fora para atuar sobre o seu próprio blob.Exemplo de requisição
curl "https://blob.vertracloud.app/v1/objects?prefix=images/&delimiter=/&limit=100" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Resposta
object
A página de objetos, as suas subpastas e o cursor da próxima página.
Mostrar propriedades
Mostrar propriedades
object[]
Objetos desta página. Cada item tem os campos de Obter um objeto de blob.
string
ID estável do objeto.
string
Caminho completo dentro da conta.
number
Tamanho em bytes.
string
public ou private.string | null
URL pública, ou
null enquanto privado.string[]
Prefixos de pasta terminando em
/. Vazio sem um delimiter.string | null
Envie-o de volta como
cursor para obter a próxima página. null na ú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
}
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING(401): o cabeçalhoAuthorizationnão foi enviado.API_KEY_INVALID(401): a chave de API não existe, foi revogada ou o segredo não confere.API_KEY_SCOPE_DENIED(403): a chave não tem o escopo que esta rota exige (blob:readoublob:write);details.requiredinforma qual.WORKSPACE_PERMISSION_DENIED(403): somente comworkspace_id: você não é membro, ou o seu papel não tem a permissão de blob.WORKSPACE_NOT_FOUND(404): somente comworkspace_id: não existe workspace com esse ID, ou você não é membro.VALIDATION_ERROR(400): um parâmetro falhou na validação, comdetails.pathindicando qual. Umcursormalformado, ou de outra consulta, retorna este erro comdetails.pathigual acursor.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
{
"code": "VALIDATION_ERROR"
}
Última modificação em 28 de outubro de 2026