Quickstart

npm install safefetch

import { safeFetch } from "safefetch";

// SAFEFETCH_API_KEY is read from env automatically
const action = await safeFetch({
  url: "https://api.example.com/send-email",
  body: { to: "user@example.com", subject: "Hello from AI" },
  approve: true,   // pause for human approval before delivery
  retries: 3,
});

console.log(action.id);     // act_01jq...
console.log(action.status); // "awaiting_approval"

{
  "id": "act_01jq...",
  "status": "awaiting_approval",
  "url": "https://api.example.com/send-email",
  "method": "POST",
  "body": { "to": "user@example.com", "subject": "Hello from AI" },
  "approve": true,
  "retries": 3,
  "attempts": 0,
  "created_at": "2025-01-01T00:00:00.000Z"
}