Obter o status de um upload do Blob para retomar
curl --request GET \
--url https://blob.vertracloud.app/v1/uploads/{upload_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/uploads/{upload_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/uploads/{upload_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/uploads/{upload_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": "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
Obter o status de um upload do Blob para retomar
Retorna o status de um upload direto e as partes já armazenadas, para que um upload interrompido possa ser retomado. Aceita um token de upload.
GET
/
v1
/
uploads
/
{upload_id}
Obter o status de um upload do Blob para retomar
curl --request GET \
--url https://blob.vertracloud.app/v1/uploads/{upload_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/uploads/{upload_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/uploads/{upload_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/uploads/{upload_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": "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"
}
}
Retorna um upload direto com
uploaded_parts, os números das partes já armazenadas. Depois de uma interrupção, envie apenas as partes que faltam. Use para retomar um upload. Um upload que expirou retorna BLOB_UPLOAD_EXPIRED.
Escopo: blob:write. Aceita um token de upload.
Token de upload: esta rota também aceita um token de upload (Authorization: Bearer vcup_...) em vez de uma chave de API.
string
obrigatório
O ID do upload retornado quando o upload foi iniciado.
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/7c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Resposta
object
O upload e as partes já armazenadas.
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.BLOB_UPLOAD_TOKEN_INVALID(401): O token de upload não existe, expirou ou foi revogado (somente com token de upload).BLOB_UPLOAD_NOT_FOUND(404): Nenhum upload com esse ID nesta conta, ou ele já foi concluído ou abortado.BLOB_UPLOAD_EXPIRED(410): O prazo do upload passou.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
{
"code": "BLOB_UPLOAD_EXPIRED"
}
Última modificação em 28 de outubro de 2026