Funciones

Una función es lógica propia de tu backend, como "reservar un turno" o "calcular un precio", que se expone como un endpoint. Las creás desde el dashboard o pidiéndoselas al asistente de IA.

Dos formas de armarlas

Una receta de pasos. Combinás pasos: buscar, crear, actualizar o borrar registros, condiciones del tipo "si pasa esto" y una respuesta. No hace falta programar.
Código JavaScript. Para lógica que los pasos no cubren. El código corre en un entorno aislado.

El entorno aislado

El código de una función corre en un sandbox sin acceso a la red, a los archivos ni a las variables de entorno del servidor. Es una decisión de seguridad: el código de una función no puede salir de su entorno. La consecuencia práctica es que una función no puede llamar a un servicio externo, por ejemplo a la API de otra empresa. Si necesitás eso, hacelo desde tu propio servidor.

Llamarla

Cada función tiene un identificador y se expone en /v1/functions/<proyecto>/<identificador>, y acepta los métodos GET, POST, PATCH y DELETE.

Terminal

curl -X POST "https://api.getforja.site/v1/functions/<ID_DEL_PROYECTO>/reservar-turno" \
  -H "Authorization: Bearer <TU_LLAVE_CON_PERMISO_FUNCIONES>" \
  -H "Content-Type: application/json" \
  -d '{ "cliente": "Ana", "dia": "2026-11-03" }'

Funciones privadas

Son las de por defecto. Se llaman con una llave del proyecto que tenga el permiso Funciones.

Funciones públicas

Se pueden llamar sin credenciales. Están pensadas para recibir avisos de otros servicios (webhooks) que no saben mandar una llave. También son la forma de que una página web guarde datos sin tener una llave de escritura en su código: la función pública valida lo que recibe y hace la escritura por dentro.

Cuidado con las funciones públicas. Las puede llamar cualquiera. Validá todo lo que recibís, no devuelvas datos que no quieras mostrar, y en los planes pagos activá el límite de pedidos por función para frenar abusos.

Según tu plan

Los planes pagos suman historial y versiones de las funciones y un límite de pedidos por función. Los planes Growth y Enterprise suman tareas programadas, que ejecutan una función de forma periódica. El detalle está en Precios.

Información revisada el 2026-10-24.