Skip to main content
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.
Requiere una clave de API con el scope 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