Create Folder

Cria uma nova pasta na estrutura de storage do cliente.

Endpoint

POST /storage-explorer/storage/folder/create

Permissões Requeridas

• STORAGE_EXPLORER.WRITE

Request Body

Campo	Tipo	Obrigatório	Descrição
folder_path	string	Sim	Caminho completo da pasta a ser criada
create_parents	boolean	Não	Criar pastas pai se não existirem (padrão: true)

Exemplo de Requisição

curl -X POST "https://maestro.dadosfera.ai/storage-explorer/storage/folder/create" \
  -H "Authorization: <JWT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "folder_path": "/raw/sales/2024/Q1",
    "create_parents": true
  }'

Exemplo de Resposta

Success (201 Created):

{
  "folder_path": "/raw/sales/2024/Q1",
  "created_at": "2024-01-15T10:30:00Z",
  "created_by": "user@dadosfera.ai",
  "parents_created": [
    "/raw/sales/2024"
  ],
  "status": "created"
}

Folder Already Exists (200 OK):

{
  "folder_path": "/raw/sales",
  "status": "already_exists",
  "created_at": "2024-01-01T00:00:00Z"
}

Regras de Nomenclatura

• Apenas letras, números, hífens e underscores
• Não pode começar ou terminar com /
• Sem espaços em branco
• Máximo 255 caracteres por nível
• Máximo 10 níveis de profundidade

Exemplos Válidos

/raw/sales
/processed/finance/2024
/analytics/reports/q1_2024

Exemplos Inválidos

/raw sales/          # Contém espaço
//raw/sales          # Barra dupla
/raw/../sales        # Navegação relativa

Casos de Uso

Criar Estrutura de Pastas para Novo Projeto

{
  "folder_path": "/projects/customer_analytics/raw",
  "create_parents": true
}

Criar Pasta de Arquivamento Mensal

{
  "folder_path": "/archive/2024/01",
  "create_parents": true
}

Códigos de Status

Código	Descrição
201	Pasta criada com sucesso
200	Pasta já existe
400	Nome de pasta inválido
401	Não autenticado
403	Sem permissão STORAGE_EXPLORER.WRITE
409	Conflito (arquivo com mesmo nome existe)