> ## Documentation Index > Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Confirmar o envio > Depois do PUT no link, confirme para o arquivo aparecer no Blob. A Cube confere que o arquivo chegou inteiro e confere a cota de novo, agora com o que já está guardado. Se já havia um arquivo com o mesmo nome, o antigo sai e o novo fica no lugar. Confirmar de novo devolve o mesmo arquivo. ## Erros comuns | Código | HTTP | O que fazer | | ------------------------------------------------------------------ | ---- | ---------------------------------------------------------------------------- | | [`upload_incomplete`](/errors#param-upload-incomplete) | 409 | Termine o `PUT` no link e confirme de novo; se ele venceu, peça outro envio. | | [`blob_quota_exceeded`](/errors#param-blob-quota-exceeded) | 413 | Outro envio entrou antes e o arquivo não coube: apague algo e envie de novo. | | [`not_found`](/errors#param-not-found) | 404 | Confira o `id` da resposta de [Pedir o envio](/api-reference/blob/create). | | [`insufficient_permission`](/errors#param-insufficient-permission) | 403 | Use uma chave de leitura e escrita ou Só Blob. | Todos os códigos, com o formato do erro, em [Códigos de erro](/errors). ## OpenAPI ````yaml POST /blob/objects/{id}/complete openapi: 3.1.0 info: title: API da Cube Hosting version: 1.0.0 description: >- Hospede bots de Discord, sites e APIs em Node.js e Python: envie o .zip, inicie, pare, reinicie, leia logs e métricas, cuide das variáveis de ambiente, faça e baixe backups, volte para uma versão anterior, crie bancos de dados (PostgreSQL, MySQL, MongoDB e Redis), guarde arquivos privados no Blob, use um domínio seu nos sites e veja o uso do plano. Para agentes de IA, o servidor MCP da conta (`POST https://app.cubehosting.com.br/api/mcp`, JSON-RPC, com a mesma chave) está em https://docs.cubehosting.com.br/account-mcp. contact: name: Cube Hosting url: https://discord.gg/pv6D9tUsDV servers: - url: https://app.cubehosting.com.br/api security: - bearerAuth: [] tags: - name: Projetos - name: Controle - name: Logs e métricas - name: Variáveis de ambiente - name: Backups - name: Versões dos envios - name: Bancos de dados - name: Blob - name: Domínios - name: Avisos - name: Conta paths: /blob/objects/{id}/complete: post: tags: - Blob summary: Confirmar o envio description: >- Segundo passo do envio, depois do `PUT` no link de [Pedir o envio](/api-reference/blob/create): a Cube confere que o arquivo chegou inteiro e confere a cota de novo, agora com o que chegou de verdade. Passou da cota (outro envio entrou antes), o arquivo sai e a resposta é `413`. Confirmado, ele aparece na lista (`status: ready`) e, se já havia um arquivo com o mesmo nome, o antigo sai. Confirmar de novo devolve o mesmo. operationId: completeBlobUpload parameters: - $ref: '#/components/parameters/BlobObjectId' responses: '200': description: O arquivo, pronto. content: application/json: schema: type: object required: - object properties: object: $ref: '#/components/schemas/BlobObject' example: object: id: 01JA3F7K2M9P4R6T8V0X1Z3B5D path: img/logo.png sizeBytes: 23456 contentType: image/png status: ready createdAt: '2026-09-28T13:10:02.000Z' '401': description: Chave ausente, inválida ou revogada. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_api_key: summary: invalid_api_key value: status: error code: invalid_api_key message: >- Chave de API inválida ou revogada. Confira o cabeçalho "Authorization: Bearer " ou crie outra em Chaves de API no painel. '403': description: A chave é só de leitura. content: application/json: schema: $ref: '#/components/schemas/Error' examples: insufficient_permission: summary: insufficient_permission value: status: error code: insufficient_permission message: >- Esta chave é só de leitura. Para enviar, iniciar, parar, reiniciar, mexer nas variáveis, fazer e baixar backups, baixar e voltar versões dos envios, criar, ligar, desligar e ver a senha dos bancos de dados ou enviar e apagar arquivos do Blob, crie uma chave de leitura e escrita no painel. '404': description: >- O arquivo não existe ou não é da sua conta (a mesma resposta para os dois). content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_found: summary: not_found value: status: error code: not_found message: Arquivo não encontrado no Blob. '409': description: O arquivo ainda não chegou inteiro pelo link. content: application/json: schema: $ref: '#/components/schemas/Error' examples: upload_incomplete: summary: upload_incomplete value: status: error code: upload_incomplete message: >- O arquivo ainda não chegou inteiro. Termine o envio pela URL (PUT) e confirme de novo; se a URL venceu, peça outra. '413': description: 'Com o que já está guardado, o arquivo passa da cota: ele sai.' content: application/json: schema: $ref: '#/components/schemas/Error' examples: blob_quota_exceeded: summary: blob_quota_exceeded value: status: error code: blob_quota_exceeded message: >- Este arquivo (200 MB) não cabe no Blob do plano Block: 4,9 GB de 5 GB já estão ocupados. Apague arquivos que não usa ou mude para um plano maior. usedBytes: 5261334937 quotaBytes: 5368709120 sizeBytes: 209715200 '429': description: Limite de pedidos. Traz o cabeçalho `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limit_exceeded: summary: rate_limit_exceeded value: status: error code: rate_limit_exceeded message: >- A sua conta passou do limite da API do plano Free: 10 pedidos por minuto. Espere 42 s e tente de novo. too_many_attempts: summary: too_many_attempts value: status: error code: too_many_attempts message: Muitas tentativas. Tente de novo em 15 minutos. '503': description: O armazenamento do Blob não respondeu. Nada mudou. content: application/json: schema: $ref: '#/components/schemas/Error' examples: blob_unavailable: summary: blob_unavailable value: status: error code: blob_unavailable message: >- O Blob não está disponível agora. Tente de novo em instantes. x-codeSamples: - lang: bash label: curl source: >- curl -X POST https://app.cubehosting.com.br/api/blob/objects/$BLOB_ID/complete \ -H "Authorization: Bearer $CUBE_API_KEY" - lang: javascript label: Node.js source: >- const API = 'https://app.cubehosting.com.br/api'; const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` }; const res = await fetch(`${API}/blob/objects/${process.env.BLOB_ID}/complete`, { method: 'POST', headers }); const { object } = await res.json(); console.log(object.status); // ready - lang: python label: Python source: >- import os import requests API = "https://app.cubehosting.com.br/api" headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"} r = requests.post(f"{API}/blob/objects/{os.environ['BLOB_ID']}/complete", headers=headers, timeout=30) r.raise_for_status() print(r.json()["object"]["status"]) components: parameters: BlobObjectId: name: id in: path required: true description: >- O ID do arquivo do Blob (26 caracteres), de [Listar arquivos do Blob](/api-reference/blob/list). schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01JA3F7K2M9P4R6T8V0X1Z3B5D schemas: BlobObject: type: object required: - id - path - sizeBytes - contentType - status - createdAt properties: id: type: string description: ID do arquivo (26 caracteres). path: type: string description: O nome, com pastas por `/` (`img/logo.png`). sizeBytes: type: integer contentType: type: string description: O tipo mandado no envio (`application/octet-stream` sem ele). status: type: string enum: - pending - ready description: '`pending` até a confirmação do envio.' createdAt: type: string format: date-time description: Quando o envio foi confirmado. Error: type: object required: - status - code - message properties: status: type: string const: error code: type: string description: Código fixo em inglês. Veja [Códigos de erro](/errors). message: type: string description: Texto em português para mostrar a uma pessoa. additionalProperties: true securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API da Cube (`cube_…`), criada no painel em **Chaves de API**. Mande como `Authorization: Bearer cube_…`. ````