Concluir um upload direto para o Blob

POST

uploads

{upload_id}

complete

curl --request POST \
  --url https://blob.vertracloud.app/v1/uploads/{upload_id}/complete \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://blob.vertracloud.app/v1/uploads/{upload_id}/complete', 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}/complete"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://blob.vertracloud.app/v1/uploads/{upload_id}/complete"

	req, _ := http.NewRequest("POST", 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"
  }
}

Finaliza um upload direto. A API verifica se todas as partes estão armazenadas, se o tamanho total confere, se o checksum confere (caso você tenha enviado um) e se o conteúdo não é um executável. Depois disso, cria o objeto e o retorna. Enquanto esta chamada não der certo, o objeto não existe. 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.

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:read (blob:manage nas rotas que alteram dados). Omita para atuar sobre o seu próprio blob.

Exemplo de requisição

curl -X POST "https://blob.vertracloud.app/v1/uploads/7c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f/complete" \
  -H "Authorization: Bearer $VERTRA_API_KEY"

Resposta

object

O objeto do blob criado.

Mostrar propriedades

string

ID estável do objeto. Ele nunca muda, mesmo quando o caminho, a visibilidade ou a expiração mudam.

string

Caminho completo dentro da conta, por exemplo images/avatars/joao.png.

number

Tamanho em bytes.

string

Tipo MIME, derivado no servidor a partir da extensão do arquivo.

string

Entity tag do conteúdo armazenado.

string | null

SHA-256 do conteúdo em hexadecimal, quando o upload enviou um checksum. Caso contrário, null.

string

public (legível pela URL pública) ou private (precisa de um link temporário ou de um compartilhamento).

string | null

URL pública. null enquanto o objeto estiver privado.

string | null

immutable, max-age=<segundos> ou no-cache (no-cache exige Enterprise-26 ou superior). null significa o padrão.

string

inline (exibido pelo navegador) ou attachment (baixado). HTML, SVG e XML são sempre attachment.

string | null

Nome sugerido no download. null usa o último segmento de path.

object

Até 5 chaves, cada uma [a-z0-9-]{1,64}, 512 bytes no total. Enterprise-12 ou superior; {} nos outros planos.

string | null

Quando o objeto é apagado, como timestamp ISO 8601. null significa sem expiração.

string

Data e hora de criação em ISO 8601.

string

Data e hora da última alteração em ISO 8601.

{
  "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"
  }
}

Respostas de erro

string

O código de erro que indica o motivo da falha. Valores possíveis:

AUTH_TOKEN_MISSING (401): Nenhum header Authorization 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 a rota exige (blob:read ou blob:write); details.required informa qual.
WORKSPACE_PERMISSION_DENIED (403): Somente com workspace_id: você não é membro, ou seu papel não tem a permissão de blob.
WORKSPACE_NOT_FOUND (404): Somente com workspace_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. Inicie um novo upload.
BLOB_UPLOAD_INCOMPLETE (409): Faltam partes, ou o tamanho armazenado difere do size declarado.
BLOB_CHECKSUM_MISMATCH (400): O conteúdo armazenado não confere com o checksum_sha256 enviado no início.
BLOCKED_FILE_TYPE (422): O conteúdo é um executável, detectado pelos seus bytes.
BLOB_OBJECT_ALREADY_EXISTS (409): O path foi ocupado por outro objeto enquanto o upload estava em andamento, e overwrite não é true.

{
  "code": "AUTH_TOKEN_MISSING"
}

{
  "code": "API_KEY_SCOPE_DENIED"
}

{
  "code": "WORKSPACE_NOT_FOUND"
}

{
  "code": "BLOB_UPLOAD_EXPIRED"
}

{
  "code": "BLOB_UPLOAD_INCOMPLETE"
}

{
  "code": "BLOB_CHECKSUM_MISMATCH"
}

{
  "code": "BLOCKED_FILE_TYPE"
}

Última modificação em 28 de outubro de 2026

Concluir um upload direto para o Blob

curl --request POST \
  --url https://blob.vertracloud.app/v1/uploads/{upload_id}/complete \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://blob.vertracloud.app/v1/uploads/{upload_id}/complete', 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}/complete"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://blob.vertracloud.app/v1/uploads/{upload_id}/complete"

	req, _ := http.NewRequest("POST", 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"
  }
}

Blob Storage

Referência da API do Blob

Concluir um upload direto para o Blob

Exemplo de requisição

Resposta

Respostas de erro

​Exemplo de requisição

​Resposta

​Respostas de erro

Exemplo de requisição

Resposta

Respostas de erro