Référence de l'API HTTP Edge Functions

URL de base. L'URL de votre projet, par exemple https://my-app.aurabase.cloud. Le projet est identifié par l'hôte, donc les chemins ci-dessous ne portent aucun identifiant de projet. La forme longue /v1/functions/{project_id}/… est également acceptée.

Authentification . Envoyez votre clé dans l'en-tête apikey. Ajoutez Authorization: Bearer <JWT> pour appeler en tant qu'utilisateur connecté. Le Studio appelle les mêmes routes avec un jeton de session de console, ce qui lui donne le rôle admin.

Tout autre itinéraire répond 403 à anon et 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" } }

Format . Les corps sont JSON et nécessitent Content-Type: application/json. Un succès est { "data": …, "meta": null }. Un échec est { "error": { "code", "message", "type", "request_id" } }.

Objet fonction.

Remarques :

• POST est un upsert sur name: poster un nom existant remplace son code. Un champ env_vars dans ce corps remplace les variables existantes ; omettez-le pour les conserver.
• Dans PATCH, permissions est fusionné champ par champ : { "permissions": { "timeout_secs": 60 } } conserve allow_net et memory_mb. Un champ en dehors de ses limites renvoie 400.
• PUT …/env remplace l'ensemble des variables et constitue la seule route qui les chiffre. Voir les secrets .
• Une fonction avec is_active: false n'est pas trouvée par invoke ni par les jobs.

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. Rôle : anon, authenticated ou service_role.

Réponse par défaut, toujours 200:

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

status est le statut de votre fonction. logs est vide pour deno. En mode brut, la réponse appartient à votre fonction : status, content-type, octets, plus x-aurabase-invoke-origin: function.

Objet de travail : id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Comportement : Travaux, cron et file d'attente de lettres mortes.

Entrée : id, project_id, name, schedule (stocké avec 6 champs), function_name, payload, is_active, last_run, next_run, created_at.

Valeurs et comportement : Alertes.