Pular para o conteúdo principal
PUT
Criar ou atualizar arquivo ou pasta da aplicação
string
obrigatório
O ID da aplicação na qual o arquivo ou pasta será criado ou atualizado. Se a aplicação pertencer a um workspace, informe o ID dele no parâmetro de query workspace_id.
string
Se a aplicação pertencer a um workspace, o ID do workspace. Membros com papel de Owner, Admin ou Developer podem usar o gerenciador de arquivos em uma aplicação do workspace que não é deles; sem isso, somente o dono da aplicação pode.
string
obrigatório
O caminho onde o arquivo ou pasta será criado ou atualizado. Termine com / para criar uma pasta.
string
O conteúdo do arquivo a criar ou atualizar. Obrigatório para arquivos; não se aplica a pastas.
string
Timestamp ISO opcional da última data de modificação (mtime) conhecida do arquivo, conforme retornado por GET /files/content. Quando informado e não corresponde ao mtime atual do arquivo no disco, o salvamento é recusado com FILE_MODIFIED em vez de sobrescrever silenciosamente uma versão mais nova — use isso para detectar conflitos de edição. Omita para salvar sem condições.
boolean
Envie true para confirmar que a alteração desvincula uma aplicação que veio de um template aberto (ela deixa de receber versões). Sem ele, a requisição não altera nada e responde 409 TEMPLATE_DETACH_CONFIRMATION_REQUIRED. Ignorado para outras aplicações. Veja Desvincular de um template.

Resposta

Em caso de sucesso, a resposta é 200 com { "response": null }.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: o cabeçalho Authorization está ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: a chave de API está sendo usada a partir de um IP fora da sua lista de permissões, ou não tem o escopo que a rota exige (403).
  • ACCESS_DENIED: o recurso pertence a outra conta, ou você não tem a permissão do workspace para ele (403).
  • FORBIDDEN: o usuário não tem permissão para acessar a aplicação.
  • APP_NOT_FOUND: a aplicação especificada não existe.
  • PLAN_RESTRICTED_FEATURE: o plano do usuário não oferece suporte ao acesso ao gerenciador de arquivos.
  • MISSING_PATH: o parâmetro de query path não foi informado.
  • MISSING_CONTENT: o parâmetro de corpo content é obrigatório para arquivos.
  • INVALID_PATH: o caminho informado é inválido.
  • TARGET_IS_DIRECTORY: o caminho já existe como pasta e não pode ser gravado como arquivo.
  • FILE_MODIFIED: o mtime atual do arquivo não corresponde ao last_modified enviado — alguém o alterou desde a última leitura. Recarregue o arquivo antes de salvar de novo.
  • PUT_FILE_FAILED: falha ao criar ou atualizar o arquivo ou pasta.
  • OWNER_APP_WITHOUT_LIMITS: os limites do plano do dono não foram encontrados.
  • TEMPLATE_DETACH_CONFIRMATION_REQUIRED: a alteração desvincularia a aplicação do seu template e confirm_detach não foi enviado (409). Nada foi alterado.
string
Uma mensagem descritiva com detalhes adicionais sobre o erro.
Última modificação em 28 de outubro de 2026