> ## 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. # Ver as regras de pasta > As regras de pasta do Blob da conta e quantas o plano tem. Cada regra vale para a pasta e as subpastas dela; com duas na mesma pasta, vale a de caminho mais longo, inteira. Guia em [Regras de pasta](/hosting/blob#regras-de-pasta). ## Erros comuns | Código | HTTP | O que fazer | | - | - | - | | [`insufficient_permission`](/errors#param-insufficient-permission) | 403 | A chave Só Blob não lê as regras: use a de leitura ou a de leitura e escrita. | Todos os códigos, com o formato do erro, em [Códigos de erro](/errors). ## OpenAPI ````yaml GET /blob/folder-rules 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, veja a análise das visitas dos sites, 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: Análise - name: Variáveis de ambiente - name: Backups - name: Versões dos envios - name: Bancos de dados - name: Blob - name: Domínios - name: Templates - name: Avisos - name: Conta paths: /blob/folder-rules: get: tags: - Blob summary: Ver as regras de pasta description: >- As regras de pasta do Blob da conta e quantas o plano tem (`limit`: 1 por GB da cota, até 50). Cada regra vale para a pasta e as subpastas dela; com duas na mesma pasta, vale a de caminho mais longo, inteira. Guia em [Blob](/hosting/blob#regras-de-pasta). operationId: listBlobFolderRules responses: '200': description: As regras e o limite do plano. content: application/json: schema: $ref: '#/components/schemas/BlobFolderRules' example: rules: - folder: backups/diarios defaultVisibility: private defaultExpirationDays: 30 cacheMaxAgeSeconds: null maxFileSizeBytes: 52428800 allowedExtensions: - zip - tar.gz deleteAfterDays: 7 deletionStartsAt: '2026-10-01T13:10:02.000Z' updatedAt: '2026-09-30T13:10:02.000Z' limit: 5 '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ó Blob (ela não lê nem mexe nas regras). 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, baixar e restaurar backups, baixar e voltar versões dos envios, criar, ligar, desligar, fazer backup e ver a senha dos bancos de dados ou enviar e apagar arquivos do Blob, crie uma chave de leitura e escrita no painel. '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. x-codeSamples: - lang: bash label: curl source: |- curl https://app.cubehosting.com.br/api/blob/folder-rules \ -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/folder-rules`, { headers }); const { rules, limit } = await res.json(); console.log(`${rules.length} de ${limit} regras`); - 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.get(f"{API}/blob/folder-rules", headers=headers, timeout=30) r.raise_for_status() print(r.json()["rules"]) components: schemas: BlobFolderRules: type: object required: - rules - limit properties: rules: type: array items: $ref: '#/components/schemas/BlobFolderRule' limit: type: integer description: >- Quantas regras o plano tem: 1 por GB da cota, até 50 (Block 5, Stack 10, Tower 25); 0 no Free. 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 BlobFolderRule: allOf: - $ref: '#/components/schemas/BlobFolderRuleInput' - type: object required: - deletionStartsAt - updatedAt properties: deletionStartsAt: type: - string - 'null' description: >- Quando o `deleteAfterDays` começa a apagar (24 horas depois de salvo); `null` sem ele. updatedAt: type: string format: date-time BlobFolderRuleInput: type: object required: - folder properties: folder: type: string description: >- A pasta (`backups/diarios`), sem `/` nas pontas; a regra vale também para as subpastas. defaultVisibility: type: - string - 'null' description: >- `public` ou `private`: a visibilidade dos envios que não dizem a deles. defaultExpirationDays: type: - integer - 'null' description: >- De 1 a 3650: em quantos dias vencem os envios que não dizem o `expiresAt`. cacheMaxAgeSeconds: type: - integer - 'null' description: >- De 60 a 31536000: o cache do link público dos arquivos enviados. Com ele, quem já abriu fica com a cópia até vencer, mesmo se o arquivo ficar privado ou for apagado. maxFileSizeBytes: type: - integer - 'null' description: O maior arquivo aceito na pasta (até 4 GB). allowedExtensions: type: array maxItems: 50 items: type: string description: As extensões aceitas (`png`, `tar.gz`); vazia aceita qualquer uma. deleteAfterDays: type: - integer - 'null' description: >- De 1 a 3650: apaga os arquivos da pasta com mais desses dias, inclusive os que já estão lá, a partir de 24 horas depois de salvar. 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_…`. ````