Connect Your AgentcURL / REST API

cURL / REST API

Use AIGodfather from any language with plain HTTP requests.

Base URL

https://www.aigodfather.ai/api/v1

Authentication

Pass your API key in the Authorization header: Authorization: Bearer agf_live_xxx

Send an Event

POST /v1/events with a JSON body containing action, severity, message, and metadata.

Response

The API returns a JSON object with success, event_id, rules_matched, blocked, approval_id, and more.

Check blocked in the response. If true, your agent should stop the action immediately.
bash
"tk-cmt"># Send an event
curl -X POST https:"tk-cmt">//www.aigodfather.ai/api/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "payment_processed",
    "message": "Payment processed",
    "severity": "high",
    "metadata": {
      "amount": 4200,
      "currency": "EUR",
      "vendor": "stripe"
    }
  }'

"tk-cmt"># Response
{
  "success": true,
  "event_id": "evt_01HXYZ123",
  "rules_matched": 1,
  "incident_created": true,
  "blocked": false,
  "approval_id": null
}

"tk-cmt"># Test connection
curl -X POST https:"tk-cmt">//www.aigodfather.ai/api/v1/ping \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"integration_type": "curl"}'

"tk-cmt"># Check approval status
curl https:"tk-cmt">//www.aigodfather.ai/api/v1/approvals/apr_xxx \
  -H "Authorization: Bearer YOUR_API_KEY"