Crear o actualizar un archivo de la aplicación
Crea o sobrescribe un archivo en una app con PUT /v2/apps//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
string
requerido
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
string
requerido
El ID de la aplicación. Puedes encontrarlo en la URL del panel de tu aplicación.
string
requerido
La ruta donde se debe crear el archivo, de hasta 256 caracteres. Ejemplo: /test.txt
string | number[]
requerido
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.string
Establécelo en
base64 cuando content sea el archivo codificado en base64. Recomendado para archivos binarios.Respuesta
string
Indica si la llamada fue exitosa:
success si lo fue, error si no.Errores comunes
Relacionado
- CLI:
squarecloud app file write - SDKs:
api.apps.files.write()(JavaScript),client.apps.files.write()(Python),c.Apps.Files.Write()(Go)

