Edge Functions Referencia de la API HTTP

URL base. La URL de su proyecto, por ejemplo https://my-app.aurabase.cloud. El host identifica el proyecto, por lo que las rutas siguientes no contienen ninguna identificación de proyecto. También se acepta la forma larga /v1/functions/{project_id}/….

Autenticación. Envíe su clave en el encabezado apikey. Agregue Authorization: Bearer <JWT> para llamar como usuario registrado. Studio llama a las mismas rutas con un token de sesión de consola, lo que le otorga la función admin.

Cualquier otra ruta responde 403 a anon y authenticated:

{ "error": { "code": "FORBIDDEN", "type": "forbidden", "request_id": "…",
  "message": "Accès interdit : Opération réservée au rôle service_role : seule l'invocation d'une fonction est ouverte aux clés publiques" } }

Formato. Los cuerpos son JSON y necesitan Content-Type: application/json. Un éxito es { "data": …, "meta": null }. Un error es { "error": { "code", "message", "type", "request_id" } }.

Objeto de función.

Notas:

• POST es una inserción en name: publicar un nombre existente reemplaza su código. Un campo env_vars en ese cuerpo reemplaza las variables existentes; omitirlo para conservarlos.
• En PATCH, permissions se fusiona campo por campo: { "permissions": { "timeout_secs": 60 } } mantiene allow_net y memory_mb. Un campo fuera de sus límites devuelve 400.
• PUT …/env reemplaza todo el conjunto de variables y es la única ruta que las cifra. Consulte los secretos de .
• Una función con is_active: false no es encontrada por invoke ni por trabajos.

curl -X POST "$AURA_URL/v1/functions" \
  -H "apikey: $AURA_SERVICE_ROLE_KEY" -H "Content-Type: application/json" \
  -d '{"name":"hello","runtime":"deno","code":"Deno.serve(() => new Response(\"ok\"))"}'

POST /v1/functions/{name}/invoke. Rol: anon, authenticated o service_role.

Respuesta predeterminada, siempre 200:

{ "data": { "status": 200, "headers": { "content-type": "application/json" },
  "body": { "greeting": "Hello, Ada!" }, "logs": [], "duration_ms": 74 }, "meta": null }

status es el estado de tu función. logs está vacío para deno. En modo sin formato, la respuesta es propia de su función: estado, content-type, bytes, más x-aurabase-invoke-origin: function.

Objeto de trabajo: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Comportamiento: Trabajos, cron y cola de mensajes fallidos.

Entrada: id, project_id, name, schedule (almacenado con 6 campos), function_name, payload, is_active, last_run, next_run, created_at.

Valores y comportamiento: Alertas.