Crear o actualizar un archivo de la aplicación
Crea o sobrescribe un archivo en una app con PUT /v2/apps/:app_id/files. Usa contenido en base64 para archivos binarios, hasta 10 MB cada uno, sin reiniciar.
PUT
Crear o actualizar un archivo de la aplicación
La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.
files:write.
Crear/Modificar archivo escribe content en path dentro de una aplicación en ejecución, creando el archivo si no existe o sobrescribiéndolo si ya existe. Para archivos binarios, envía content codificado en base64 junto con encoding: "base64", el formato recomendado. content también acepta una cadena UTF-8 para archivos de texto, un array simple de bytes ([104, 105]) o un objeto { type: "Buffer", data: number[] }. Un content vacío ("" o []) escribe un archivo vacío. Cada escritura admite hasta 10 MB, medidos sobre los bytes decodificados. Las escrituras están limitadas a 10 solicitudes cada 5 segundos por usuario. Úsalo para ediciones pequeñas y puntuales, como ajustar un valor de configuración o incorporar un archivo generado, sin volver a subir toda la aplicación; para cambios masivos o un .zip, usa en su lugar Enviar Commit a la Aplicación.
Escribir en squarecloud.app o squarecloud.config se trata de forma especial: la plataforma lo interpreta como la configuración de la aplicación (nombre visible, descripción, memoria, autorestart, subdominio) y valida cada campo; un valor inválido devuelve un código de error específico (por ejemplo INVALID_MEMORY o INVALID_SUBDOMAIN) en lugar de escribir el archivo. Estas reescrituras de configuración están limitadas a 1 solicitud cada 15 segundos por usuario.
En aplicaciones compartidas en un workspace, quien llama necesita el rol maintain o admin, y los miembros sin el permiso de archivos restringidos no pueden escribir en rutas excluidas como .env. Al igual que otras rutas del administrador de archivos, esto no reinicia la aplicación; llama a Reiniciar aplicación para aplicar cambios que requieran un proceso nuevo.
Parámetros
El contenido del archivo que se va a crear: base64 cuando
encoding es base64; en caso contrario, una cadena UTF-8 o un array de bytes.Establécelo en
base64 cuando content sea el archivo codificado en base64. Recomendado para archivos binarios.Respuesta
Errores comunes
Relacionado
- CLI:
squarecloud app file write - SDKs:
api.apps.files.write()(JavaScript),client.apps.files.write()(Python),c.Apps.Files.Write()(Go)

