Listar uploads do Blob em andamento
curl --request GET \
--url https://blob.vertracloud.app/v1/uploads \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/uploads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/uploads"
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/uploads"
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": "7c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
"path": "videos/demo.mp4",
"mode": "multipart",
"status": "pending",
"size": 2147483648,
"expires_at": "2026-10-14T13:00:00.000Z",
"headers": {
"content-type": "video/mp4"
},
"part_size": 67108864,
"part_count": 32,
"uploaded_parts": [],
"created_at": "2026-10-14T12:00:00.000Z"
}
]
}
Uploads
Listar uploads do Blob em andamento
Lista os uploads diretos da conta que ainda estão em andamento, para que você possa retomá-los ou abortá-los.
GET
/
v1
/
uploads
Listar uploads do Blob em andamento
curl --request GET \
--url https://blob.vertracloud.app/v1/uploads \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/uploads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/uploads"
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/uploads"
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": "7c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
"path": "videos/demo.mp4",
"mode": "multipart",
"status": "pending",
"size": 2147483648,
"expires_at": "2026-10-14T13:00:00.000Z",
"headers": {
"content-type": "video/mp4"
},
"part_size": 67108864,
"part_count": 32,
"uploaded_parts": [],
"created_at": "2026-10-14T12:00:00.000Z"
}
]
}
Lista os uploads diretos da conta que ainda estão
pending. Use depois de uma interrupção para encontrar o ID de um upload e, em seguida, leia o uploaded_parts dele com Obter status do upload.
Escopo: blob:write.
string
O ID do workspace, quando o blob pertence a um workspace. A chamada atua sobre o blob do dono do workspace e precisa da permissão de workspace
blob:manage, porque os uploads em andamento pertencem a quem gerencia os arquivos. Omita para atuar sobre o seu próprio blob.Exemplo de requisição
curl "https://blob.vertracloud.app/v1/uploads" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Resposta
object[]
Os uploads em andamento.
Mostrar propriedades
Mostrar propriedades
string
ID do upload. Use-o para status, partes, conclusão e aborto.
string
Caminho final, incluindo o sufixo aleatório quando ele foi pedido.
string
single (um PUT do arquivo inteiro para url) ou multipart (várias partes, cada uma com sua própria URL).string
pending, completed, aborted ou expired.number
Tamanho declarado em bytes. Os bytes armazenados precisam bater com ele em
complete.string
Quando as URLs e o armazenamento reservado expiram, como timestamp ISO 8601.
string
Somente no modo
single: a URL para fazer PUT do arquivo inteiro.object
Headers que o
PUT deve enviar exatamente como informados, porque fazem parte da assinatura.number
Somente no modo
multipart: o tamanho fixo de cada parte em bytes. A última parte pode ser menor.number
Somente no modo
multipart: quantas partes o arquivo tem.number[]
Números das partes já armazenadas. Use-os para retomar um upload interrompido.
string
Data e hora de criação em ISO 8601.
{
"response": [
{
"id": "7c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
"path": "videos/demo.mp4",
"mode": "multipart",
"status": "pending",
"size": 2147483648,
"expires_at": "2026-10-14T13:00:00.000Z",
"headers": {
"content-type": "video/mp4"
},
"part_size": 67108864,
"part_count": 32,
"uploaded_parts": [],
"created_at": "2026-10-14T12:00:00.000Z"
}
]
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING(401): Nenhum headerAuthorizationfoi 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 a rota exige (blob:readoublob:write);details.requiredinforma qual.WORKSPACE_PERMISSION_DENIED(403): Somente comworkspace_id: você não é membro, ou 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.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
Última modificação em 28 de outubro de 2026