CLI Reference

npm install -g @safefetch/cli

npx @safefetch/cli --help

export SAFEFETCH_API_KEY=sf_live_...
export SAFEFETCH_API_URL=https://api.safefetch.dev   # optional, this is the default

SAFEFETCH_API_KEY=sf_live_...
SAFEFETCH_API_URL=https://api.safefetch.dev

safefetch --api-key sf_live_... list

safefetch send --url <url> [options]

Options:
  --url <url>              Target URL (required)
  --method <method>        HTTP method (default: POST)
  --body <json>            JSON body as a string
  --retries <n>            Max delivery retries (default: 3)
  --dedupe <key>           Deduplication key
  --callback <url>         Callback URL called after delivery
  --approve                Require human approval before delivery
  --sync                   Wait for the action to complete and return the full result
  --idempotency-key <key>  Idempotency key

safefetch send --url https://example.com/api/notify

safefetch send \
  --url https://example.com/api/notify \
  --body '{"user_id":"u_123","event":"signup"}' \
  --retries 5

safefetch send \
  --url https://example.com/api/delete-account \
  --body '{"user_id":"u_123"}' \
  --approve

safefetch send \
  --url https://example.com/api/notify \
  --sync

safefetch send \
  --url https://example.com/api/notify \
  --dedupe order_456

safefetch send \
  --url https://example.com/api/notify \
  --idempotency-key req_789

safefetch get <act_id>

safefetch get act_V1StGXR8_Z5j

safefetch list [options]

Options:
  --status <status>    Filter by status (pending, awaiting_approval, delivered, failed, cancelled)
  --limit <n>          Number of results (default: 20)
  --offset <n>         Pagination offset (default: 0)

safefetch list

safefetch list --status failed

safefetch list --limit 50 --offset 50

safefetch approve <act_id>

safefetch approve act_V1StGXR8_Z5j

safefetch cancel <act_id>

safefetch cancel act_V1StGXR8_Z5j

safefetch retry <act_id>

safefetch retry act_V1StGXR8_Z5j

safefetch health

--api-key <key>    API key (overrides SAFEFETCH_API_KEY)
--api-url <url>    API base URL (overrides SAFEFETCH_API_URL)
--version          Print the CLI version
--help             Show help